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WELCOME  TO  AF-GEOSPACE  VERSIONS  2.5.1  AND  2.5.1P 


AF-GEOSpace  is  a  user-friendly,  graphics-intensive  master  program  bringing  together  many  of 
the  space  environment  models  and  applications  developed  over  the  years  by  the  Air  Force 
Research  Laboratory,  its  contractors,  and  collaborators.  The  program  has  grown  steadily  in  an 
effort  to  address  the  concerns  of  the  space  weather  community,  to  assist  in  providing  an 
historical  validation  baseline  for  relating  models  covering  similar  domains,  and  to  act  as  a 
development  tool  for  automated  space  weather  visualization  products.  It  provides  common  input 
data  sets,  application  modules,  and  1-D,  2-D,  and  3-D  visualization  tools  to  all  of  its  models.  AF- 
GEOSpace  provides  operators,  engineers,  forecasters,  scientists,  students,  and  teachers  with  tools 
to  accomplish  a  wide  variety  of  tasks,  for  example; 

•  Optimal  orbit  specification  for  avoidance  of  radiation  hazards 

•  Satellite  design  assessment  and  post-event  anomaly  analysis 

•  Forecasting  of  solar  disturbance  effects 

•  Frequency  and  antenna  management  for  radar  and  HF  communications 

•  Determination  of  communication  link  outage  regions  for  active  ionospheric  conditions 

•  Specification  of  meteor  flux  rates  along  orbits  plus  probabilities  of  incurring  damage 

•  Display  of  user- formatted  space  environment  sensor  data  with  orbit  trajectories 

•  Display  of  user-generated  3-D  gridded  simulation  results  for  model  comparison 

•  Display  of  DMSP  particle  spectra  and  integrated  flux  from  the  SSJ4/5  particle  sensors 

•  Display  tools  for  interpreting  MHD  simulation  results  on  large-scale  structured  grids 

•  Determination  of  location  of  geomagnetic  footprints  of  satellites  for  conjunction  studies 

•  Determination  of  spacecraft  distance  from  the  magnetopause  boundary  layer 

•  Specification  of  overall  atmosphere,  ionosphere,  aurora,  plasmasphere,  radiation  belt,  and 
magnetosphere  particle  populations 

•  General  interplanetary,  magnetospheric,  and  ionospheric  physics  research  and  education 

A  review  of  the  software  development  history  reveals  a  strong  emphasis  on  retaining  and 
enhancing  the  capabilities  of  earlier  releases. 

Development  Overview 

The  first  public  release  of  AF-GEOSpace  was  Version  1.21  (1996;  IRIX  on  SGI)  contained 
radiation  belt  particle  flux  and  dose  models  derived  from  CRRES  satellite  data,  an  aurora  model, 
an  ionospheric  model  and  HF  ray  tracing  capabilities.  Version  1.4,  (1999;  IRIX  on  SGI)  added 
science  modules  related  to  the  cosmic  ray  and  solar  proton  environment,  low -Earth  orbit 
radiation  dosages,  single  event  effects  probability  maps,  and  ionospheric  scintillation,  solar 
proton,  and  shock  propagation  models.  New  application  modules  for  estimating  linear  energy 
transfer  (LET)  and  single  event  upset  (SEU)  rates  in  solid-state  devices,  and  modules  for 
visualizing  radar  fans,  communication  domes,  and  satellite  detector  cones  and  links  were  added. 
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Automated  FTP  scripts  permitted  users  to  automatically  update  their  global  input  parameter  data 
set  directly  from  the  NOAA  National  Geophysical  Data  Center  (NGDC). 

AF-GEOSpace  Version  2.0  (2002;  Windows)  included  the  first  true  dynamic  run  capabilities  and 
offered  new  and  enhanced  graphical  and  data  visualization  tools  such  as  3-D  volume  rendering 
and  eclipse  umbra  and  penumbra  determination.  The  dynamic  run  capability  enabled  the 
animation  of  all  model  results,  in  all  dimensions,  as  a  function  of  time.  Version  2.0  also  included 
a  new  realistic  day-to-day  ionospheric  scintillation  simulation  generator  [lONSClNT],  an 
upgrade  to  the  WideBand  Model  scintillation  code  [WBMOD],  a  simplified  HF  ionospheric  ray 
tracing  module  [RAYTRACE-APP],  and  applications  built  on  the  NASA  AE-8  and  AP-8 
radiation  belt  models  [NASAEEE-APP  andNASAPRO-APP].  In  addition,  user-generated 
satellite  data  sets  could  be  visualized  along  with  their  orbital  ephemerides  [EPHEMERIS]  and  a 
tool  was  provided  for  visualizing  MHD  model  results  stored  in  structured  grids  [PARAMESH]. 

AE-GEOSpace  V2.1  (2006;  Windows)  followed  with  new  capabilities:  (1)  to  trace  geomagnetic 
field-lines  from  user-specified  points  or  points  along  a  satellite  orbital  track  [BEOOTPRINT- 
APP],  (2)  calculate  cutoff  rigidity  values  for  solar  protons  and  cosmic  rays  for  any  altitude  from 
within  the  Earth’s  atmosphere  to  beyond  geosynchronous  orbit  [CEITOEE],  (3)  display  particle 
energy  spectra  and  integrated  precipitating  flux  from  the  DMSP  SSJ4/5  sensors  [DMSP],  (4) 
calculate  hourly  meteor  impact  or  damage  rates  for  a  given  cross  section,  pit  depth,  and  material 
type  on  a  user-specified  surface  area  at  positions  outside  of  the  Earth's  atmosphere  [METEOR 
IMPACT  MAP],  (5)  estimate  meteor  flux  or  damage  rates  as  well  as  cumulative  probabilities  for 
a  user-specified  surface  as  a  function  of  time  along  an  orbit  path  [METEOR  IMPACT-APP],  (6) 
estimate  the  number  of  meteors  visible  from  ground-level  resulting  from  active  meteor  showers 
(or  user-specified  storms)  [METEOR  SKY  MAP],  (7)  generate  time-dependent  flux  profiles  of 
electron,  H^,  and  O^  particle  fluxes  in  the  inner  and  middle  magnetosphere  [MSM],  (8)  compute 
atmospheric  number  densities,  total  mass  density  and  temperature  as  well  as  anomalous  oxygen 
number  density  and  exospheric  temperature  [NRLMSISE-00],  (9)  model  the  solar-cycle 
dependent  low-altitude  extension  of  the  proton  radiation  belt  [TPM-1],  and  (10)  calculate  omni¬ 
directional  proton  fiuence  (integral  and  differential)  along  user-specified  orbits  [TPM-l-APP]. 

What’s  New? 

AE-GEOSpace  Version  2.5.1,  containing  the  same  set  of  software  modules  as  Version  2.5  (2010; 
Windows),  has  undergone  extensive  additional  testing  and  debugging  to  ensure  compatibility 
with  the  Windows  7  operating  system.  As  such,  this  user’s  manual  contains  only  minor  editorial 
revisions  when  compared  to  that  of  Version  2.5.  Version  2.5  expanded  on  the  content  of  Version 
2.1  by  including  new  modules  and  updates  related  to  the  following  topics:  (1)  energetic  proton 
maps  for  the  South  Atlantic  Anomaly  for  the  epoch  2000-2006  [SAAMAPS-2007],  (2)  GPS 
scintillation  outage  simulation  tools  [lONSCINT-G,  lONSCINT-G-APP,  plus  the  related 
lONSCINT-G  graphics  module],  (3)  magnetopause  boundary  location  determination 
[MAGNETOPAUSE],  (4)  a  2008  empirical  description  of  thermal  plasma  densities  in  the 
plasmasphere,  plasmapause,  magnetospheric  trough,  and  polar  cap  [GCPM],  (5)  the  International 
Reference  Ionosphere  model  [IRI-2007],  (6)  a  new  inner  magnetosphere  plasma  population 
model  [CAMMICE],  (7)  new  dynamic  magnetic  field  models  driven  by  archived  input 
coefficients  valid  back  to  1963  [BEIELD-APP  and  BEOOTPRINT-APP],  (8)  the  ability  to 
display  externally-produced  3D  gridded  data  sets  [GRID],  (9)  a  2005  update  to  the  geomagnetic 
cutoff  rigidity  model  [CUTOEE],  (10)  a  2005  update  to  the  ionospheric  scintillation  Wide-Band 
Model  [WBMOD],  (11)  improved  magnetic  field  flux  mapping  options  for  the  existing  set  of 
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AF-GEOSpace  radiation  belt  models  [APEXRAD,  CRRESEEE,  CRRESPRO,  CRESSRAD  and 
TPM-1],  and  (11)  the  capability  to  display  the  latest  DMSP  data  sets  [DMSP]. 

Code  Architecture 

AE-GEOSpace  Version  2.5.1  is  an  object-oriented  code  written  in  C++  for  Windows  (XP,  Vista, 
and  7).  It  is  rigorously  object  oriented  and  contains  separate  user  interface,  kernel,  and  graphics 
libraries.  The  software  is  divided  into  five  explicit  module  classes  to  simplify  the  integration  of 
new  algorithms  and  increase  portability.  Science  Modules  control  individual  science  models  and 
produce  output  data  sets  on  user-specified  grids.  Application  Modules  typically  manipulate  these 
data  sets,  e.g.,  by  integrating  dose  calculated  by  a  radiation  belt  model  or  tracing  HP  rays  through 
a  model  ionosphere.  Application  modules  also  provide  orbit  generation  and  magnetic  field  line 
tracing  capabilities.  Data  Modules  read  and  assist  with  the  analysis  of  user-generated  and  DMSP 
data  sets.  Graphics  Modules  control  the  one,  two,  and  three-dimensional  windows  and  enable 
display  features  such  as  plane  slices,  magnetic  field  lines,  line  plots,  axes,  the  Earth,  stars,  and 
satellites.  Worksheet  Modules  provide  commonly  requested  coordinate  transformations  and  a 
calendar  system  conversion  tools. 

Comments 

Perhaps  the  most  important  parts  of  this  document  are  found  at  the  end  in  the  EXAMPLES 
section.  There  you  will  find  click-by-click  instructions  for  using  AP-GEOSpace  to  investigate 
solar,  magnetospheric,  and  ionospheric  phenomena  that  have  well  known  effects  on 
communications  and  spacecraft  systems.  Examples  exercising  the  dynamic  run  feature  of  AP- 
GEOSpace  are  marked  as  such  in  the  title. 

AP-GEOSpace  software  is  distributed  exclusively  by  the  Space  Weather  Center  of  Excellence 
within  the  Space  Vehicles  Directorate  of  APRL.  The  AP-GEOSpace  development  team 
appreciates  comments,  bug  reports,  and  content  suggestions  for  future  software.  Contact 
information  is  in  the  PRODUCT  INEORMATION  section  at  the  end  of  this  document. 
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Release  Notes  on  the  User’s  Manual  and  Software 

The  AF-GEOSpace  User’s  Manual,  Version  2.5.1  and  Version  2. 5.  IP  (this  document),  approved 
for  unlimited  public  distribution,  describes  two  AF-GEOSpace  software  applieation  paekages 
released  coneurrently  by  the  Air  Foree  Research  Laboratory  (AFRL).  AF-GEOSpace  software 
was  developed  by  the  FIS  Air  Force  and  cannot  be  redistributed  or  copied  in  whole  or  in  part  for 
sale.  The  USAF  and  the  Air  Foree  Researeh  Laboratory  are  not  liable  for  any  damages  resulting 
from  the  use  of  the  information  eontained  in  this  doeument  or  the  eomputer  software  it  deseribes. 

Version  2.5.1  software  (DVD),  distributed  by  AFRL  to  pre-approved  government  institutions 
and  their  agents,  includes  the  eomplete  inventory  of  Science  and  Application  Modules  listed  in 
the  table  of  eontents  of  this  User’s  Manual.  Members  of  the  general  publie  who  wish  to  obtain 
this  version  of  the  software  should  eontact  the  AF-GEOSpaee  development  team  to  initiate  the 
neeessary  release  approval  proeedure. 

Version  2.5. IP  software  (CD),  approved  for  unlimited  publie  distribution,  is  identieal  to  the 
Version  2.5.1  software  exeept  for  the  absenee  of  seven  Science  Modules  (i.e.,  lONSCINT, 

ISPM,  MSM,  PPS,  STOA,  TPM-1,  and  WBMOD)  and  two  Application  Module  (i.e.,  TPM-APP 
and  WBPROD-APP)  marked  “V2.5.1  Only”  in  the  table  of  contents.  If  interested  in  obtaining 
the  modules  excluded  from  Version  2.5.  IP,  please  contact  the  AF-GEOSpaee  development  team. 

Automated  Installation  of  AF-GEOSpace 

(1)  Insert  the  AF-GEOSpace  Software  Media 

If  the  Install  window  does  not  appear,  then  run  the  setup.exe  program  directly.  [If  the  setup 
popup  window  does  not  appear  or  you  are  requested  to  provide  an  administrative  user 
name/password  but  do  not  have  administrative  privileges,  then  please  follow  the  Manual 
Installation  instructions  detailed  in  the  next  section.] 

(2)  Set  the  Install  Directory 

A  new  direetory  named  “AFGeospace”  will  be  ereated  in  the  seleeted  Install  Directory.  The 
Install  Directory  path  name  can  have  a  maximum  of  35  characters.  All  executable  and  data 
files  will  be  copied  into  the  Install  Directory.  Note;  All  future  referenees  made  in  this  document 
to  the  “AFGeospaee”  directory  path  will  use  the  name  “$AFGS_HOME”. 

(3)  Set  the  Scratch  Directory 

When  AF-GEOSpaee  runs  eaeh  model  ereates  a  direetory  where  temporary  data  needed  to  run 
the  model  is  stored.  When  the  model  is  deleted,  or  AF-GEOSpaee  exits,  these  directories  are 
deleted.  The  Seratch  Directory  path  tells  AF-GEOSpaee  where  to  ereate  these  direetories. 

(4)  Select  links  to  he  created  (to  Start  Menu  and/or  Desktop) 

Links  to  run  AF-GEOSpace  can  be  automatically  placed  in  the  Start  >Programs  menu  and  on  the 
windows  Desktop.  Place  a  cheek  in  the  Add  to  Start  Menu  and/or  Make  Desktop  Shortcut  boxes 
to  ereate  the  links.  Note:  AF-GEOSpaee  will  need  to  be  installed  with  write  permission  to  the 
Start  menu  directory  structure  for  the  links  to  be  suecessfully  ereated. 

(5)  Install  AF-GEOSpace 

Click  the  Install  button  to  begin  the  aetual  installation.  The  Install  window  will  show  installation 
progress  and  issue  a  completion  message.  The  Cancel  button  will  interrupt  installation. 


4 

Approved  for  public  release;  Distribution  is  unlimited. 
AF-GEOSpace  User’s  Manual:  Version  2.5.1 


Option  for  Version  2,5.1:  If  the  MSM  Science  Module  is  required,  copy  the  DVD  directories 
TLBMAT  and  BMATRIX {1.5  GB  total)  into  the  directory  $AFGS_HOME\models\data\MSM. 

Manual  Installation  of  AF-GEOSpace 

(1)  Insert  the  AF-GEOSpace  Software  Media 

(2)  Create  the  Install  Directory 

Create  a  new  directory  called  “AFGeospace”  for  use  as  the  installation  location.  The  path  name 
of  the  directory  where  “AFGeospace”  is  placed  can  have  a  maximum  of  35  characters.  Copy  the 
bin  and  models  directories  from  the  media  and  place  them  in  the  new  directory  AFGeospace. 
Note  that  all  future  references  made  in  this  document  to  the  “AFGeospace”  directory  path  will 
use  the  name  “$AFGS_HOMF”. 

(3)  Edit  the  Batch  Files  for  Running  AF-GEOSpace  and  Updating  Global  Inputs 

Copy  the  fdes  named  AFGeospace.bat  and  AFGetSec.bat  and  place  them  in  the  newly  created 
machine  directory  $AFGS_HOME\bin.  Each  file  contains  a  set  of  commands  to  set  machine 
environment  variables  followed  by  a  call  to  an  executable  file,  namely 

File  AFGeospace.bat: 

1)  set  PLGS  MODELS=C : \Users\username\AFGeospace 

2)  set  PLGS“SCRATCH_DIRECTORY=C: \TEMP 

3)  set  PLGS_DMSP  DATADIR=C : \Users\username\AFGeospace\models\data\DMSP\2003 

4 )  "C : \Users\username\AFGeospace\bin\AFGeospace . exe" 

File  AFGetSec.bat: 

1)  set  PLGS  MODELS=C : \Users\username\AFGeospace 

2)  set  PLGS”SCRATCH_DIRECTORY=C: \TEMP 

3 )  "C : \ User s\ username \AFGeo space \bin\AFGet Sec . exe" 

Initially,  fictitious  paths  are  set  for  the  location  of  the  bin  and  models  directories,  i.e., 
$AFGS_HOME  =  C:\Users\username\AFGeospace  in  the  sample  file  content  shown  above.  Edit 
both  files  to  reflect  your  install  location,  i.e.,  replace  the  character  string  “C:\Users\username”  in 
each  of  lines  1,  3,  and  4  of  file  AFGeospace.bat  and  also  in  lines  1  and  3  of  file  AFGetSec.bat 
with  a  character  string  designating  the  actual  location  of  directory  AFGEOSpace. 

(4)  Confirm  Location  of  the  Scratch  Directory 

As  AF-GEOSpace  runs,  each  new  module  creates  a  directory  where  temporary  data  needed  to 
run  the  model  is  stored.  The  default  location  of  the  scratch  directory  as  noted  in  both  batch  files 
is  c :  \TEMP.  If  this  directory  does  not  currently  exist  on  your  machine,  then  either  create  one  or 
edit  line  2  of  both  batch  files  to  specify  the  location  of  an  existing  directory  to  be  utilized  for 
scratch  space.  Note  that  when  the  model  is  deleted,  or  AF-GEOSpace  exits,  the  temporary  data 
directories  are  deleted. 

(5)  Create  a  Desktop  Shortcut 

Right-click  on  the  newly  edited  file  $AFGS_HOME\binVlFGeo5pace.hat  and  select  Create 
Shortcut.  Place  the  shortcut  on  your  Desktop  or  elsewhere  for  convenient  access  to  the  software. 

(6)  Option  for  Version  2.5,1:  If  the  MSM  Science  Module  is  required,  copy  the  DVD 
directories  TLBMAT  and  BMATRIX {\  .5  GB  total)  into  the  directory 
$AFGS_HOME\models\data\MSM. 
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Running  AF-GEOSpace 

To  run  AF-GEOSpace,  double-click  on  the  AF-GEOSpace  Desktop  icon  or  use  the  Start  menu 
{Start  >  Programs  >AFGeospace  >  AFGeospace).  If  no  links  were  created  during  installation, 
start  AF-GEOSpace  by  going  to  the  $AFGS_HOME\bin  directory  and  double-clicking  on  the 
AFGeospace.bat  file.  Be  aware  that  the  file  AFGeospace.bat  contains  Environment  Variable 
settings  specific  to  the  Install  and  Scratch  directories  you  selected  during  the  installation  process. 
For  this  reason,  if  you  would  like  to  change  the  location  of  any  part  of  the  installation  it  is  best  to 
first  remove  AF-GEOSpace  completely  (see  Removing  AF-GEOSpace  below)  and  then  re-install 
it  to  properly  designate  the  preferred  Install  and  Scratch  directory  locations. 

Note;  AF-GEOSpace  will  not  work  properly  if  you  run  the  AFGeoSpace.exe  file  directly. 

Three  windows  will  appear  on  your  screen.  One  is  the  AF-GEOSpace  graphical  user  interface 
(GUI)  with  a  set  of  pull-down  menu  items  across  the  top.  The  other  two  are  shell  windows  (plain 
text  windows,  usually  with  black  backgrounds).  You  can  minimize  these  to  clean  the  desktop, 
but  the  shell  windows  must  remain  open  for  AF-GEOSpace  to  function.  To  optimize  the 
quality  of  the  display  layout  and  increase  ease  of  use,  it  is  best  to  maximize  the  AF-GEOSpace 
GUI  window  immediately  upon  starting  a  session. 

When  large  fonts  are  used  in  your  display,  the  text  in  the  GUI  Environment  Window  may  appear 
to  overlap  or  be  crowded.  If  this  occurs,  adjusting  your  display  to  use  small  fonts  should  clean  up 
your  AF-GEOSpace  display  layout. 

At  the  end  of  this  document,  some  AF-GEOSpace  examples  are  provided  with  detailed  step-by- 
step  instructions  to  help  the  user  visualize  results  from  both  static  and  dynamic  model  runs. 

An  electronic  copy  of  this  document  can  be  found  in  $AFGS_HOME\models\HEEP. 

Removing  AF-GEOSpace 

To  remove  AF-GEOSpace,  delete  the  $AFGS_HOME  directory.  If  a  desktop  icon  was  created 
then  place  it  in  the  recycle  bin.  If  a  link  in  the  Start  menu  was  created,  remove  the  AFGeospace 
submenu  item  by  following  the  Start  Menu  handling  instructions  available  using  Start  >  Help. 
Because  the  installation  does  not  modify  the  machine  registry,  removal  is  complete  at  this  point. 

A  Note  on  Virtual  Memory 

If  users  find  the  machine  running  out  of  virtual  memory,  the  virtual  memory  paging  file  size  can 
be  adjusted  by  following  the  instructions  found  using  Windows  Help. 
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ENVIRONMENTS 


Environment  modules  provide  interfaces  to  the  science  models  and  related  applications  needed  to 
investigate  the  solar,  interplanetary,  magnetospheric,  auroral,  and  ionospheric  environments  and 
their  effects  on  communications  and  spacecraft  systems.  AF-GEOSpace  Version  2.5.1  supports 
two  basic  environment  module  types:  static  and  dynamic.  Modules  that  do  not  operate  in 
dynamic  mode  are  marked  as  “Static  Only”  in  the  table  of  contents  of  this  manual. 

Upon  opening  AF-GEOSpace,  an  Environment  Window  is  displayed  containing  a  menu  bar  and 
an  input  section  for  specifying  the  module  run  times  and  global  parameters  used  to  drive  models 
during  the  session.  When  using  AF-GEOSpace  to  do  comparative  studies  of  space  environments 
for  different  geophysical  conditions  it  is  recommended  that  a  new  AF-GEOSpace  session  be 
used  for  each  case,  i.e.,  for  each  time  or  time  period.  Remember  that  the  models  contained  in  AF- 
GEOSpace  were  developed  independently  over  a  period  of  many  years  by  a  variety  of  authors. 

Static  versus  Dynamic  Mode 

Static  Mode:  A  Science  or  Application  module  run  is  called  static  if  it  produces  output 
representing  a  single  Universal  Time,  i.e.,  only  the  Start:  Year,  Day,  and  UT  text  fields  are 
completed  in  the  global  input  row  at  the  top  of  the  Environment  Window.  All  environment 
models  and  applications  are  run  using  a  fixed  set  of  geophysical  parameters,  e.g.,  the 
geomagnetic  activity  index  Kp.  With  the  exception  of  the  MSM  Science  Module  and  the  satellite 
orbit  generator  SATEE-APP  and  associated  applications  (APEXRAD-APP,  BFOOTPRINT- 
APP,  CRRESEEE-APP,  CRRESPRO-APP,  CRRESRAD-APP,  EET-APP,  METEOR  IMPACT- 
APP,  NASAEEE-APP,  NASAPRO-APP,  TPM-APP)  all  environment  models  and  applications 
can  be  run  for  a  fixed  Universal  Time. 

Dynamic  Mode:  A  Science  or  Application  module  run  is  called  dynamic  if  it  produces  output  at 
more  than  one  Universal  Time,  i.e.,  both  the  Start:  and  End:  Year,  Day,  and  UT  text  fields  are 
completed  in  the  global  input  row  at  the  top  of  the  Environment  Window.  It  must  be  emphasized 
that  most  dynamic  module  runs  are  composed  of  a  time-ordered  sequence  of  static  runs.  A 
dynamic  mode  run  is  established  by  placing  a  check  mark  in  the  small  box  to  the  right  of  the 
Start:  UT  text  field  to  activate  the  End:  Year,  Day,  and  UT  text  fields.  Selecting  one  of  the 
Globals  options  to  the  right  of  the  time  input  text  fields  will  create  a  chronological  list  of  global 
input  parameters  that  module  runs  will  share  during  the  session.  This  common  set  of  global  input 
parameters  allows  you  to  automatically  run  models  in  a  coordinated  manner  so  that  output 
displays  of  varying  types  of  generated  physical  parameters,  e.g.,  auroral  precipitation  patterns 
and  geomagnetic  field  lines,  will  be  consistent  with  each  other  to  the  greatest  extent  possible 
without  truly  coupling  the  models.  Again,  the  SATEE-APP  orbit  generation  module  and  related 
applications  work  in  both  static  and  dynamic  mode.  When  SATEE-APP  is  opened  in  static 
mode,  the  satellite  orbit  will  be  calculated  for  the  1-day  interval  beginning  with  the  Start  time. 
However,  when  SATEE-APP  is  opened  in  dynamic  mode  the  satellite  orbit  will  automatically  be 
calculated  for  the  entire  time  period  defined  by  the  entered  Start/End  time  limits. 
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Global  Parameters 


Global  parameters  are  the  date,  time,  and  geophysieal  indiees  shared  between  many  of  the 
models.  The  purpose  of  the  global  parameters  seetion  is  to  help  maintain  eonsistent  inputs  to  the 
plurality  of  models  that  ean  be  ereated  within  a  single  statie  or  dynamie  environment.  Most 
models  have  additional  parameter  inputs  that  will  be  requested  when  initializing  the  appropriate 
module. 

IMPORTANT  NOTE;  THE  FIRST  THING  A  USER  MUST  DO  AFTER  OPENING  AN  AF- 
GEOSPACE  APPEICATION  IS  SET  THE  TIME  AND  OBTAIN  THE  GEOBAL  INPUT 
PARAMETERS.  The  following  time  and  global  parameter  input  eontrols  are  loeated  in  a  row 
just  below  the  pull-down  menus  at  the  top  of  the  window: 

Start:  (three  items  are  set  for  both  statie  and  dynamie  runs) 

Year:  Start  Year 

Day:  Start  Julian  day  of  year  in  the  form  DDD 
UT:  Start  Universal  Time  in  the  form  HH;MM 

“Box”:  To  set  up  a  dynamie  run,  plaee  a  eheek  mark  in  the  box  next  to  the  Start:  UT  text  field 

and  the  following  three  end  time  text  fields  will  beeome  aetive. 

End;  (three  items  are  set  for  dynamie  runs  only) 

Year:  End  Year 

Day:  End  Julian  day  of  year  in  the  form  DDD 
UT:  End  Universal  Time  in  the  form  HH:MM 

Kp:  Planetary  magnetie  aetivity  index  input  in  deeimal  form 

SSN:  Daily  sunspot  number 

F10.7;  Instantaneous  solar  radio  flux  at  10.7  em  (2800  MHz)  in  10~^^Wm^Hz~^ 

Ap:  Planetary  magnetie  index  in  integer  form 

Kp,  SSN,  F10.7,  and  Ap  are  provided  for  1932  through  April  2012  and  their  definitions  are 
identieal  to  those  used  for  the  geophysieal  index  arehives  maintained  by  the  National 
Geophysieal  Data  Center  (NGDC)  in  Boulder,  Colorado. 

After  the  time  text  fields  are  adjusted,  the  user  must  use  the  Global  seleetor  (options  are  Archive, 
Prelim,  ox  Latest  as  deseribed  below)  to  retrieve  the  global  inputs  and  initialize  AF-GEOSpaee 
with  the  run  time.  The  geophysieal  indiees  are  flagged  with  the  unphysieal  values  of  “-1”  if  data 
are  not  available  for  the  seleeted  time  or  interval.  Values  for  these  flagged  parameters  or  any  of 
the  parameters  ean  then  be  direetly  edited  using  the  text  boxes.  As  deseribed  in  the  Menu  seetion, 
the  input  parameters  extraeted  from  the  data  files  ean  be  adjusted  for  dynamie  runs  using  the 
Globals:Show  pulldown  menu.  Editing  the  parameters  direetly  before  running  a  module  allows 
the  user  to  run  the  entered  time  or  interval  using  parameters  not  eontained  in  the  global  data  sets. 
Additional  parameters  aeeessible  via  the  Globals:Show  pulldown  menu  are, 

Dst:  Geomagnetie  aetivity  index  in  nT  (1957  through  May  2012) 
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EqE;  Equatorward  boundary  of  the  diffuse  aurora  at  midnight  in  units  of  degrees  magnetie 
latitude  (1983  through  Day  83  of  2010) 

Note  that  most  modules  will  provide  a  summary  of  times  run  and  input  parameters  used  in  the 
Model  Status  box  at  the  bottom  of  the  Environment  Window. 

The  global  parameter  values  ean  be  plotted  in  a  ID  viewport  window  using  the  Global  Inputs 
graphieal  module.  The  last  two  parameters  are  ineluded  for  referenee  purposes.  The  Dst 
parameter  is  useful  when  eonstrueting  magnetic  field  models  using  the  BEIEED-APP  application 
and  the  EqE  values  are  useful  as  manual  input  to  the  AEIRORA  science  module  equatorward 
edge-mapping  algorithm. 

These  options  for  the  global  parameters  files  are  given  below. 

Archive 

When  Globals: Archive  is  selected,  the  NGDC  archived  values  of  the  geomagnetic  indices  valid 
for  the  Year,  Day,  and  Time  entered  in  the  respective  global  parameter  boxes  are  automatically 
loaded.  AE-GEOSpace  Version  2.5.1  contains  the  NGDC  geophysical  index  archive  files  in  the 
directories: 

$AFGS_HOME\models\data\GEOBAES\KP  (contains  indices  Kp,  SSN,  El 0.7,  and  Ap) 

$AEGS_HOME\models\data\GEOBAES\DST  (contains  the  Dst  magnetic  index) 

Each  file  in  these  directories  contains  a  year’s  worth  of  indices  with  the  current  year’s  file  only 
partially  full.  The  AF-GEOSpace  convention  is  to  label  the  files  kpNNNN  and  dstNNNN, 
respectively,  where  NNNN  is  the  year.  Thus  the  indices  for  1991  are  stored  in  the  files  kpl991 
and  dstl991  in  the  KP  and  DST  directories  noted  above,  respectively. 

It  is  straightforward  to  keep  the  archived  data  in  AF-GEOSpace  up-to-date  by  downloading  the 
most  recent  NGDC  archived  data  files.  The  NGDC  file  containing  the  indices  Kp,  SSN,  El 0.7, 
and  Ap  is  updated  periodically.  An  example  showing  how  to  update  Kp,  SSN,  El 0.7,  and  Ap  in 
the  AF-GEOSpace  database  from  the  NGDC  archive  might  have  been  made  during  March  of 
2012  is  given  next.  At  a  Windows  command  prompt,  type 

cd  $AFGS_HOME\models\data\GEOBAES\KP 
ftp  ftp.ngdc.noaa.gov 

(log  in  using  the  username  “anonymous”  and  your  local  e-mail  address  as  a  password) 
ftp>  cd  STP/GEOMAGNETIC_DATA/INDICES/KP_AP 
ftp>  Is 

(screen  listing  shows  yearly  files  listed  with  the  latest  and  smallest  being  2012) 
ftp>  get  2012 
ftp>  quit 

rename  kp20 12  kp2012old 
rename  2012  kp2012 
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The  procedure  for  obtaining  Dst  data  for  a  given  year  is  similar,  e.g.,  at  a  Windows  command 
prompt,  type 

cd  $AFGS_HOME\models\data\GLOBALS\DST 
ftp  ftp.ngdc.noaa.gov 

(log  in  using  the  username  “anonymous”  and  your  local  e-mail  address  as  a  password) 
ftp>  cd  STP/GEOMAGNETIC_DATA/INDICES/DST 
ftp>  Is 

(screen  listing  shows  latest  file  is  dst2008.txt) 
ftp>  get  dst2008.txt 
ftp>  quit 

rename  dst2008  dst2008old 
rename  dst2008.txt  dst2008 

Dst  files  for  later  years,  including  periodic  updates,  can  be  retrieved  from  the  website  for  the 
World  Data  Center  for  Geomagnetism  in  Kyoto  Japan  (i.e.,  at  http://wdc.kugi.kyoto-u.ac.jp/) 

Prelim 

When  Prelim  is  selected  from  the  Globals  button,  the  values  of  the  geomagnetic  indices  (Kp, 
SSN,  F10.7,  Ap)  from  the  near-real  time  file  (see  Latest  below)  valid  for  the  Year,  Day,  and  Time 
values  entered  in  the  global  parameter  boxes  are  automatically  loaded.  The  data  base  of  near-real 
time  estimates  can  be  used  to  run  AF-GEOSpace  for  time  periods  not  yet  covered  by  the  NGDC 
archive.  Before  using  Prelim,  try  the  Latest  option  to  determine  the  extent  of  the  available  data. 

Latest 

When  Latest  is  selected  with  the  Globals  button,  the  most  recent  time  and  global  indices  (Kp, 
SSN,  F10.7,  Ap)  available  for  the  Year  entered  in  the  global  parameter  box  are  automatically 
loaded  from  the  corresponding  file  in  directory, 

$AFGS_HOME\models\data\GEOBALS\RT 

The  files  in  this  directory  contain  estimates  of  the  indices  as  computed  by  NOAA  and  can  be 
updated  daily  (see  Daily  Parameters  Over  the  Internet  below).  If  kept  current,  the  data  estimates 
will  be  valid  for  the  previous  day.  Eile  naming  conventions  and  formats  are  identical  to  the 
NGDC  archive  files,  with  the  exception  of  a  header  line  giving  the  data  and  time  of  the  most 
recent  update.  Note  that  these  parameter  estimates  for  a  given  date  often  differ  from  the  values 
that  eventually  appear  in  the  NGDC  archive  files.  Note:  The  anonymous  ftp  script  controlled  by 
file  AFGetSec.bat  (see  next  section)  must  be  executed  at  least  once  for  the  Latest  function  to 
work. 

Daily  Parameters  Via  the  Internet 

Daily  updates  of  files  from  NOAA/NGDC  containing  selected  geomagnetic  and  solar  activity 
indices  are  available  via  anonymous  FTP  from  ftp.sec.noaa.gov  in  the  directory  named 
pub/latest.  AF-GEOSpace  provides  the  scripts  needed  to  automatically  retrieve  these  fdes  on  a 
daily  basis  and  use  them  to  update  the  data  file  accessed  when  using  the  Prelim  and  Latest 
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features  described  above.  The  procedure  for  establishing  the  daily  update  is  given  below  and 
relies  on  the  following  files: 

$AFGS_HOME\bin\AFGetSec.bat  (created  during  installation) 

$AFGS_HOME\bin\AFGetSec.exe 

$AFGS_HOME\models\data\Sec\ftpcmd 

The  batch  file  AFGetSec.bat  is  created  during  installation.  It  sets  the  two  environment  variables 
PLGS  MODELS  (location  of  bin  and  models  directories)  and  PLGS  SCRATCH  DIRECTORY 
(location  where  FTP  files  are  processed),  and  calls  the  executable  program  AFGetSec.exe.  Note 
that  the  default  installation  sets  PFGS_MODEFS=c:\Program  Files\AFGeospace  and  sets 
PFGS_SCRATCH_DIRECTORY=c:\TEMP 

AFGetSec.exe  performs  an  FTP  session  using  input  from  file  ftpcmd,  then  appends  the  new  data 
from  the  SEC  files  to  the  latest  Kp  file  in  $AFGS_HOME\models\data\GFOBAFS\RT.  Note  that 
the  source  fide  for  this  procedure  is  $AFGS_F[OME\models\data\Sec\AFGetSec.for. 

Procedure  for  setting  up  automated  daily  parameter  updates: 

(1)  Follow  the  first  set  of  FTP  instructions  in  the  Archive  section  above  to  place  the  most  recent 
full  Kp  file,  e.g.,  file  kp2002,  in  the  directory  $AFGS_HOME\models\data\GFOBAFS\KP. 

(2)  Place  a  duplicate  copy  of  the  most  recent  full  Kp  file  (obtained  in  step  above)  in  the  directory 
$AFGS_HOME\models\data\GFOBAFS\RT  and  adjust  its  properties  so  that  it  can  be 
updated  (e.g.,  right-click  on  file  Kp2002,  select  the  Properties  option,  and  clear  the  Read¬ 
only  check  box). 

(3)  Edit  the  second  line  of  file  ftpcmd  to  use  your  e-mail  address  as  the  anonymous  ftp  password. 
The  file  can  be  opened  using  a  text  editor  like  Notepad. 

(4)  Test  the  procedure  by  double-clicking  on  the  file  AFGetSec.bat.  A  shell  window  will  appear 
briefly  as  the  ftp  process  takes  place.  If  successful,  the  PFGS  SCRATCH  DIRECTORY 
will  contain  five  temporary  fdes,  Q.g.,  ftpcmd,  kp2002,  MAda.txt,  sec.bat,  and  SGAS.txt.  File 
$AFGS_HOME\models\data\GLOBALS\RT\kp2002  should  now  contain  a  new  first  line  (the 
date)  and  last  line  (date  and  data).  If  the  five  new  files  appear  but  the  Kp  file  was  not 
updated,  check  that  the  Kp  file  Properties  (right-click  on  file)  are  not  set  as  Read-only  and 
test  again. 

(5)  To  establish  an  automated  daily  data  update,  use  the  Task  Scheduler  in  the  Windows  Control 
Panel  to  run  the  file  AFGetSec.bat  once  daily. 
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Mouse  Buttons 


Mouse  controls  are  provided  to  facilitate  manipulation  of  the  2D  and  3D  window  view  and 
display  environment  window  options  and  color  bars  associated  with  displayed  graphical  objects. 

Left:  Depress  the  left  mouse  button  and  move  it  around  while  its  pointer  is  within  a  3D 

window  to  rotate  displayed  objects. 

Right:  Depress  the  right  mouse  button  and  move  it  toward/away  from  the  screen  while 

its  pointer  is  within  a  2D  or  3D  window  to  expand/contract  the  view,  i.e.,  to  zoom. 

^Az/t+Left:  While  depressing  the  Shift  key,  apply  the  left  mouse  button  and  move  its  pointer 
around  within  a  3D  window  to  translate  the  view  in  the  X,  Y,  or  Z  directions  and 
move  it  around.  In  a  2D  window,  this  same  combination  can  be  used  to  re-center 
the  Earth  map  display.  Users  with  an  Intellimouse  can  also  depress  the  mouse’s 
center  wheel  to  perform  this  translate  function. 

Ctr/-l-Left:  While  depressing  the  Ctrl  key,  use  the  left  mouse  button  to  click  on  an  object  in  a 
2D  or  3D  window  and  the  related  environment  window  options  and  color  bar  will 
be  displayed. 
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Getting  Started 

To  run  AF-GEOSpace,  double-click  on  the  Geospace.bat  icon  in  the  $AFGS_HOME\bin 
folder  (or  on  a  shortcut  icon  if  one  was  created)  and  three  windows  will  appear:  the  AE- 
GEOSpace  graphical  user  interface  (GEII)  with  a  set  of  pulldown  menus  and  two  diagnostic 
screens.  The  diagnostic  windows  can  be  minimized  to  clean  up  your  desktop,  but  they  must 
remain  open  for  the  application  to  function  properly  (for  some  modules,  the  diagnostic  window 
will  contain  run-time  messages).  To  optimize  the  quality  of  the  GET  layout,  it  is  best  to 
maximize  the  AF-GEOSpace  GUI  window.  The  Help  menu  will  guide  you  to  the  PDF  version  of 
this  document. 

To  start  using  AF-GEOSpace  Version  2.5.1  most  effectively,  review  the  MENUS  section  of  this 
manual  and  then  go  directly  to  the  EXAMPLES  section.  The  examples  contain  step-by-step 
instructions  that  will  guide  you  through  a  complete  AF-GEOSpace  session  that  includes  the 
generation  and  visualization  of  space  environment  parameters.  The  Exit  option  in  the  Eile  menu 
terminates  AF-GEOSpace  and  deletes  all  objects  and  graphics  created  during  the  session. 

All  comments  regarding  the  current  capabilities  of  AF-GEOSpace  and  ideas  for  future  versions 
of  the  software  are  appreciated.  Contact  information  is  in  the  PRODUCT  INEORMATION 
section  at  the  end  of  this  document. 
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MENUS 


The  menu  bar  at  the  top  of  eaeh  environment  provides  access  to  functions  for  managing  science, 
application,  data,  and  graphics  modules;  create  graphics  windows,  and  access  help.  This  section 
describes  the  File,  Edit,  View,  Module,  Window,  Viewport,  Globals,  and  Help  menus  in  turn. 
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File  Menu 

The  File  menu  provides  aeeess  to  features  enabling  the  user  to  load  MHD  simulation  data  files 
for  viewing,  save/open  eompleted  model  runs,  save/open  window  views,  save  window  graphies, 
and  exit  an  AF-GEOSpaee  session.  The  File  menu  button  accesses  the  following  options. 

Open  Paramesh 

The  Open  Paramesh  function  allows  the  user  to  read-in  or  load  MHD  simulation  run  results 
produced  externally  to  AF-GEOSpace  using  large-scale  parallel  grid  generation  and  MHD 
science  codes  developed  by  the  Navel  Research  Eaboratory  (NRL)  for  the  Common  High 
Performance  Computing  (HPC)  Software  Support  Initiative  (CHSSI)  collaborative  project 
under  way  with  AFRE.  Each  simulation  is  stored  in  an  individual  folder  in  the  form  of  a 
flicks. hdr  file,  a  flicks. fir  file,  and  a  numbered  set  of flicks.#####  fdes  with  one  fide  for  each 
time  step.  The  Open  Paramesh  function  produces  a  popup  window  for  locating  the  folder 
containing  the  data  files  for  the  simulation  of  interest.  Selecting  the  flicks. hdr  file  within  a 
folder  and  using  the  Open  button  in  the  popup  window  will  load  the  saved  data  files  and 
place  an  NRLMHD  entry  in  the  Active  Modules  list  of  the  Science  Environment  Window. 

The  data  will  then  be  available  for  display  using  the  Paramesh  related  graphics  modules 
within  a  special  Heliospace  viewport.  Create  a  Heliospace  viewport  by  changing  any  active 
window  by  using  the  Viewport  menu  and  selecting  Projection  and  then  the  Heliospace 
options.  More  details  regarding  a  description  of  and  access  to  Paramesh  data  files  can  be 
found  at  the  NRL  website  {http://www.lcp.nrl.navy.mil/hpcc-ess/amrmhd3d.10.html)  or  by 
contacting  the  AF-GEOSpace  team  at  AFRE.  An  AF-GEOSpace  session  entitled 
“HELIOSPACE:  Loading  and  Viewing  PARAMESH  Files”  is  described  in  the  EXAMPLES 
section  at  the  end  of  this  manual. 

Open  Model 

The  Open  Model  function  allows  the  user  to  read-in  or  load  Environment  Window  inputs  and 
run  results  of  previously  saved  Science  and  Application  modules.  Modules  are  saved  as 
single  Common  Data  Format  (CDF)  files  using  the  Save  Model  function  (see  below). 

The  Open  Model  function  produces  a  popup  window  for  selecting  from  existing  CDF  fdes. 
Selecting  a  *.cdf  file  and  using  the  Open  button  in  the  popup  window  will  load  the  saved 
module  and  place  an  appropriate  entry  in  the  Active  Modules  list  of  either  the  Science  or 
Application  Environment  Window.  The  data  produced  by  the  module  is  then  available  for 
display  using  the  graphics  modules.  Note  that  while  the  original  grid  settings  do  not  appear 
when  the  new  entry  in  the  Active  Modules  list  is  selected  and  the  Edit  menu  Grid  Tool  option 
(see  below)  is  selected,  the  grid  information  is  stored  internally.  For  modules  producing  only 
text  output,  the  Show  Text  button  in  the  Environment  Window  of  the  reloaded  Science  or 
Application  module  must  be  selected  to  see  the  output. 

Before  opening  a  static  model  run,  the  appropriate  Start  time  should  be  re-enterer  in  the  text 
fields  at  the  top  of  the  window  and  the  Globals: Archive  feature  should  be  selected. 

Before  opening  dynamic  model  runs,  the  appropriate  Start  and  End  times  should  be  re¬ 
entered  in  the  text  fields  at  the  top  of  the  window  and  the  Globals:  Archive  feature  should  be 
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-reselected.  Then  when  using  the  Animate  Tool  (in  the  Edit  pulldown  menu),  the  Range 
Times  button  can  be  used  to  automatically  set  its  Time  Start  and  Time  End  fields. 

For  both  the  static  and  dynamic  run  cases,  it  is  very  convenient  to  store  all  saved  model  files 
representing  a  particular  time  period  in  a  directory  with  a  name  containing  a  time  label  (see 
hint  in  Save  Model  section  below). 

Open  View 

The  Open  View  function  allows  the  user  to  load  a  view  saved  previously  using  the  Save  View 
function  described  below.  The  Open  View  function  produces  an  Open  popup  window  for 
selecting  from  existing  view  files  (no  specific  file  suffix  required).  Select  a  view  file  and  use 
the  Open  button  in  the  popup  window  to  reset  the  view  of  the  active  3D  window  to  match  the 
saved  view. 

Save  Model 

The  Save  Model  function  allows  the  user  to  save  Environment  Window  input  settings  and  run 
results  of  Science  and  Application  modules  as  single  CDF  files  for  future  use.  This  feature 
works  for  modules  run  in  both  static  and  dynamic  modes.  Saved  models  can  be  reloaded 
using  the  Open  Model  function  described  above. 

To  save  a  model  run:  (1)  Select/highlight  a  science  or  application  module  entry  in  an  Active 
Modules  list  for  a  module  that  has  been  run,  i.e.,  the  message  MODEL  IS  READY  AND  UP 
TO  DATE  must  appear  in  the  Model  Status  window  at  the  bottom  of  the  Environment 
Window.  Note  that  graphics,  data,  and  worksheet  module  results  cannot  be  saved.  (2)  Access 
the  Save  Model  option  in  the  Edit  pulldown  menu  and  a  Save  As  popup  window  will  appear. 
Locate  the  directory  for  storing  the  CDF  to  be  created,  enter  a  file  name,  and  click  the  Save 
button.  When  the  Save  As  window  disappears,  the  inputs  and  data  from  the  run  module  have 
been  written  to  a  CDF  file  in  the  designated  directory  and  can  be  accessed  in  the  future  using 
the  Open  Model  feature  described  above. 

Hint:  It  is  suggested  that  models  representing  a  particular  time  period  be  saved  together  in  a 
directory  named  to  designate  the  time  period,  e.g.,  one  might  place  saved  model  runs  in  a 
directory  called  “1995_185_0000tol400by7200”  to  represent  a  run  made  for  UT=00:00  to 
14:00  on  day  185  of  year  1995  using  a  dynamic  step  size  of  7200  seconds.  This  will  make 
viewing  and  animating  the  saved  output  much  simpler  after  using  the  Open  Model  feature 
described  above.  Note  that  the  Exit  option  of  the  Eile  pulldown  menu  removes  all  files 
located  in  folders  generated  by  AF-GEOSpace  during  a  session  so  it  is  best  to  place  CDF 
files  elsewhere. 

Save  Window  As 

The  Save  Window  As  function  is  used  to  save  the  contents  of  the  active  window  in  Tagged 
Image  File  Format  (TIFF)  or  Joint  Photographic  Experts  Group  (JPEG)  format.  This  feature 
opens  a  Save  As  window  to  specify  the  format,  file  name,  and  save  location.  While  TIFF 
images  are  sharper  than  JPEG  images,  they  also  result  in  much  larger  files.  Note  that  the  Exit 
option  of  the  Eile  pulldown  menu  removes  all  files  located  in  folders  generated  by  AF- 
GEOSpace  during  a  session  so  it  is  best  to  place  saved  graphics  fdes  elsewhere. 
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Save  View 

The  Save  View  function  is  used  to  save  the  view  currently  visible  in  an  active  3D  window. 
This  feature  opens  a  Save  As  window  to  specify  the  file  name  (no  specific  file  suffix 
required)  and  save  location.  No  specific  file  suffix  is  required.  After  a  view  is  saved,  and  the 
Earth  has  been  moved  for  example,  the  saved  view  can  be  restored  by  using  the  Open  View 
function  described  above.  Note  that  the  Exit  option  of  the  File  pulldown  menu  removes  all 
files  located  in  folders  generated  by  AF-GEOSpace  during  a  session  so  it  is  best  to  place 
saved  view  fdes  elsewhere. 

Print  (or  Qr/+P) 

The  Print  function  is  currently  inactive,  i.e.,  it  prints  blank  pages.  To  print  a  window’s 
contents,  use  the  Save  Window  As  option  above  and  then  imbed  the  saved  TIFF  or  JPEG 
images  in  another  file  for  printing.  To  print  the  entire  screen,  use  the  Print  Screen  Key 
(PrntScrn  or  PrtScn)  to  capture  the  entire  screen  in  the  buffer  and  then  “paste”  it  into  another 
document  for  printing. 

Print  Preview 

The  Print  Preview  function  is  currently  inactive. 

Print  Setup 

The  Print  Setup  function  displays  the  standard  Windows  Print  Setup  window. 

Exit 

The  Exit  function  terminates  the  program  and  deletes  all  session  folders  in  the  assigned 
scratch  folder  that  were  created  by  AF-GEOSpace.  Files  generated  using  the  Save  Model, 
Save  Window  As,  and  Save  View  functions  should  not  be  stored  in  these  temporary  session 
folders  if  they  need  to  be  accessed  in  the  future. 
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Edit  Menu 

The  Edit  menu  provides  access  to  features  enabling  the  user  to  run  models,  delete  models, 
rename  entries  in  the  Active  Modules  lists,  examine  text  representations  of  module  produced 
data,  setup  computation  grids,  set  dynamic  run  mode  time  step  values  and  parameter  selection, 
and  animate  results  from  dynamic  module  runs  (including  satellite  orbits  in  static  mode).  The 
Edit  menu  accesses  the  following  options. 

Run/Update  (or  Ctrl+K) 

The  Run/Update  function  is  used  to  run  Science,  Application,  and  Data  modules  after  setting 
all  desired  inputs.  A  Process  View  popup  window  will  appear  indicating  that  the  module  is 
running  and  will  disappear  when  complete.  A  message  in  the  Model  Status  window  at  the 
bottom  of  the  environment  window  will  read  that  the  “MODEL  IS  READY  AND  TIP  TO 
DATE”  to  indicate  that  the  generated  data  are  available  for  use  by  the  graphics  modules. 
Depending  on  the  type  of  module  run,  the  Model  Status  window  may  also  provide  a  brief 
message  regarding  the  time  of  the  run  and  the  global  parameters  used.  A  scroll  feature 
enables  the  user  to  view  longer  text  outputs  to  the  Model  Status  window. 

Delete  (Active  Module) 

The  Delete  function  is  used  to  remove  entries  from  the  Active  Modules  lists.  When  displayed 
graphics  modules  are  deleted,  the  graphic  will  disappear  from  the  viewport  the  next  time  the 
window  is  accessed.  Before  deleting  active  Science,  Application,  or  Data  modules,  all 
related  graphics  displays  must  be  removed  (popup  warnings  are  displayed  if  this  is  not  done). 

Rename 

The  Rename  function  enables  the  user  to  rename  entries  in  the  Active  Modules  lists.  A 
Rename  Model  popup  window  will  appear  containing  an  editable  text  box  for  entering  a  new 
name  for  the  module.  This  feature  is  convenient,  for  example,  when  multiple  coordinate 
slices  (produced  using  the  Coord  Slice  graphics  module)  representing  multiple  types  of 
science  model  data  appear  in  the  active  graphics  modules  list. 

Data  Tool 

The  Data  Tool  function  provides  an  interface  to  view  a  data  set  in  a  formatted,  tabular  output 
form.  Selecting  the  Data  Tool  function  after  highlighting  a  science  or  application  module  in 
an  Active  Modules  list  will  produce  a  Data  Viewer  popup  window  for  viewing  the  data  set 
produced  using  that  module.  In  order  to  view  three-dimensional  data  sets  in  a  two- 
dimensional  tabular  format,  the  Data  Viewer  window  allows  the  user  to  assign  one  dimension 
of  the  dataset  to  the  columns  and  another  dimension  to  the  rows  of  the  tabular  output.  The 
data  selector  appears  at  the  top  of  the  Data  Viewer  window.  Dimensions  are  assigned  to 
Columns  and  Rows  using  the  button  switches  at  the  bottom  of  the  window.  The  “slice”  (i.e., 
the  third  unassigned  dimension)  at  which  the  columns  and  rows  are  extracted  is  controlled 
using  the  lower  slider.  The  user  can  scan  through  the  two  assigned  dimensions  using  the 
scroll  bars  immediately  adjacent  to  the  text  window.  The  Done  button  retires  the  Data 
Viewer  window. 
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Grid  Tool  (or  ar/+G) 

The  Grid  Tool  option  opens  a  popup  window  that  allows  one  to  speeify  the  type  and 
resolution  of  the  grid  used  by  science  and  application  modules.  If  the  default  grid  settings  are 
desired  then  the  Grid  Tool  need  not  be  used.  After  selecting  from  the  Grid  Tool  options 
described  below,  clicking  the  Apply  button  or  closing  the  Grid  Tool  window  will  generate  the 
grid.  The  Cancel  button  should  be  used  to  exit  the  Grid  Tool  Window  if  no  grid  changes  are 
desired.  Note:  The  coordinate  labels  Radius,  etc.,  will  change  to  correspond  to  the  different 
types  of  systems  chosen.  One  must  close  the  Grid  Tool  window  in  order  to  activate  any 
changes. 

The  Grid  Tool  options  are: 

Spacing:  Specifies  the  manner  in  which  the  grid  spacing  is  calculated.  Choices  are: 

Linear:  Equally  spaced  grid  points  along  the  coordinate  direction  are  generated. 

N-S  Symm:  Symmetrically  spaced  grid  points  along  the  North-South  direction  are 
generated  and  no  grid  points  exist  in  the  equatorial  regions  (useful  for  auroral 
calculations).  For  example,  with  a  spherical  Geometry  setting  the  grid  points  are  evenly 
spaced  between  the  absolute  value  of  the  specified  minimum  and  maximum  latitudes  in 
both  the  Southern  and  Northern  hemisphere,  e.g.,  for  a  minimum  latitude  of  50“  and  a 
maximum  latitude  of  90“,  grid  points  will  be  evenly  spaced  between  50“  and  90“  North 
latitude  and  50°  and  90“  South  latitude.  No  grid  points  will  exist  between  50“  South  and 
50“  North  latitude. 

Geometry:  Specifies  the  geometry  of  the  grid.  Choices  are: 

Cartesian:  generate  a  grid  in  Cartesian  geometry. 

Cylindrical:  generate  a  grid  in  cylindrical  geometry. 

Spherical:  generate  a  grid  in  spherical  geometry. 

System:  Specifies  the  coordinate  system  of  the  grid.  The  choices  are: 

GEOC:  Geocentric  coordinate  system:  The  Z  axis  is  aligned  with  the  north  rotational  pole, 
the  X  axis  pierces  the  Greenwich  Meridian  on  the  equator  (0  “  Long,  0  “  Eat),  and  the  Y 
axis  is  minus  the  cross-product  of  X  and  Z. 

GSM:  Geocentric  solar  magnetospheric  coordinate  system:  The  X  axis  points  to  the  Sun. 
The  Z  axis  is  perpendicular  to  X  and  lies  in  the  plane  containing  the  magnetic  dipole  axis. 
The  Y  axis  completes  the  right-handed  system  and  is  positive  towards  dusk. 

SM:  Solar  magnetic  coordinate  system:  The  X  axis  is  perpendicular  to  Z  and  lies  in  the 
plane  containing  the  Z  axis  and  the  Earth-Sun  line.  The  Z  axis  is  coincident  with  the 
magnetic  dipole  axis.  The  Y  axis  completes  the  right-handed  system  and  is  positive 
towards  dusk. 

GEI:  Geocentric  equatorial  inertial  coordinate  system:  The  Z  axis  is  the  same  as  for  the 
geocentric  coordinate  system  {GEOC).  The  X  axis  points  in  the  direction  of  the  first  point 
of  Aries  (vernal  equinox).  The  Y-axis  completes  the  right-handed  system.  The  angle 
between  the  X-axis  and  Greenwich  Meridian  is  set  by  the  UT. 
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Set  (?,  ?,  ?):  For  each  of  the  three  coordinates,  the  user  must  input  the  grid  sizes.  Each 
coordinate  contains  a  selection  list  for  setting  combinations  of  three  of  the  four  variables 
needed  to  specify  this  coordinate.  The  variables  are, 

Delta:  the  interval  between  nodes. 

NPoint:  the  total  number  of  nodes. 

Min:  the  minimum  coordinate  value. 

Max:  the  maximum  coordinate  value. 

Dynamic  Tool 

The  Dynamic  Tool  allows  the  user  to  select  the  time  steps  for  running  science  and  application 
modules  and  choose  which  data  parameters  to  write  to  file  for  viewing  dynamic  run  results. 

A  text  box  indicates  the  number  of  dynamic  steps  to  be  taken  (maximum  allowed  is  200),  the 
times  at  which  to  run  the  model,  and  information  regarding  global  parameters  to  be  used. 

To  reduce  both  run  time  and  the  size  of  environment  data  files  created  by  AF-GEOSpace,  the 
user  should  take  into  account  the  time-dependent  nature  of  the  module  to  be  run  when 
selecting  the  Time  Step.  For  example,  if  a  radiation  belt  model  such  as  CRRESEEE  is  run 
using  the  very  slowly  time-varying  IGRF85  magnetic  field,  then  setting  Time  Step  to  values 
less  than  a  day  (86400  sec)  does  not  improve  the  accuracy  of  the  CRRESEEE  science 
module  output.  If,  however,  the  same  CRRESEEE  model  is  run  using  the  dipole  tilt- 
dependent  IGRF85/0-P  option  (that  includes  an  external  magnetic  field  component),  a  Time 
Step  of  two  hours  (7200  sec)  could  be  considered  reasonable. 

A  Dynamic  Tool  window  appears  with  the  following  settings: 

Variable  to  write  to  file:  Select:  This  section  shows  the  available  data  parameters  that  can 
be  generated  by  the  selected  module.  Only  those  selected  will  be  viewable  with  the 
graphics  modules.  If  no  parameters  are  selected,  then  an  Error  popup  reading  “No  data 
selected  for  output”  will  appear  when  a  run  is  attempted. 

Time  Step  (sec):  The  time  between  dynamic  steps.  The  selected  module  will  be  run  once  at 
each  time  step. 

Update  List:  The  Update  List  button  uses  the  selected  Time  Step  to  adjust  the  number  of 
times  a  model  is  run  within  the  Start  and  End  times  specified  at  the  top  of  the  Environment 
Window 

Done:  Exits  the  Dynamic  Tool 

Animate  Tool  (or  Ctrl+A) 

Selecting  the  Animate  Tool  allows  the  user  to  animate  orbits  and  data  sets  in  the  ID,  2D,  3D, 
and  Heliospace  windows.  This  tool  brings  up  an  Animate  Window  for  controlling  animation 
effects.  Graphics  representing  data  from  science,  application,  and  data  modules  are  updated 
individually  as  the  animation  time  slider  passes  a  time  at  which  a  model  was  processed.  For 
example,  if  the  selected  Time  Step  is  60  seconds  and  a  satellite  position  was  generated  every 
60  seconds  but  magnetic  field  lines  were  only  produced  once  every  3  hours,  the  magnetic 
field  lines  will  appear  to  jump  suddenly  at  three  hour  intervals. 

The  Animate  Window  entries  are  described  below. 
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Time;  Text  box  and  slider  to  set  the  eurrent  date  and  time. 

Animate:  Starts/stops  the  animation  stepper  at  the  time  indieated  by  the  Time  slider. 

Interactive;  When  aetivated,  ail  environments  update  automatieally  when  the  Time  slider 
position  is  ehanged. 

Time  Start:  Sets  the  start  time  for  the  stepper  in  day,  hour,  and  minute. 

Time  End:  Sets  the  stop  time  for  the  stepper  in  day,  hour,  and  minute. 

Time  Step  (Sec):  Sets  the  time  inerement  for  the  stepper  in  seeonds. 

Update:  Registers  ehanges  made  to  settings  in  the  Animate  window. 

Range  Times:  Set  the  range  of  the  step  times  from  the  overall  minimum  and  maximum  time 
for  all  the  dynamie  modules  used.  In  statie  mode,  when  SATEL-APP  is  the  only  dynamie 
model  engaged,  the  range  is  set  for  one  day  in  length  beginning  with  the  Start  time. 

Done:  Exits  the  animation  module. 
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View  Menu 

The  View  menu  button  accesses  the  following  options. 

Tool  Bar 

The  Tool  Bar  option  is  currently  inactive. 

Status  Bar 

The  Status  Bar  is  located  at  the  bottom  of  the  Environment  Window.  It  indicates  when  the 
interface  is  ready  for  input  and  also  indicates  the  function  of  some  pulldown  menu  items 
when  selected  using  the  left  mouse  button. 
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Module  Menu 

The  Module  menu  provides  aeeess  to  Seienee,  Applieation,  Data,  Graphies,  and  Worksheet 
modules.  Most  of  the  functionality  of  AF-GEOSpace  is  accessed  via  this  menu.  The  Module 
menu  button  accesses  the  following  options. 

Science  (or  F2) 

The  Science  option  under  the  modules  pulldown  menu  provides  access  to  the  science 
manager.  Once  activated,  lists  of  Available  and  Active  Science  modules  are  visible.  Science 
modules  may  be  managed  by  making  appropriate  choices  from  these  lists. 

Applications  (or  F3) 

The  Applications  option  under  the  modules  pulldown  menu  provides  access  to  the  application 
manager.  Once  activated,  lists  of  Available  and  Active  Application  modules  are  visible. 
Applications  may  be  managed  by  making  appropriate  choices  from  these  lists. 

Graphics  (or  F4) 

The  Graphics  option  under  the  modules  pulldown  menu  provides  access  to  the  graphics 
module  manager.  Once  activated,  lists  of  Available  and  Active  Graphics  modules  are  visible. 
Graphical  modules  may  be  managed  by  making  appropriate  choices  from  these  lists. 

Data  (or  F5) 

The  Data  option  under  the  modules  pulldown  menu  provides  access  to  the  data  module 
manager.  Once  activated,  lists  of  Available  and  Active  Data  modules  are  visible.  Data 
modules  may  be  managed  by  making  appropriate  choices  from  these  lists. 

Worksheets  (or  FT) 

The  Worksheet  option  under  the  modules  pulldown  menu  provides  access  to  the  worksheets 
manager.  Once  activated,  lists  of  Available  and  Active  Worksheet  modules  are  visible. 
Worksheets  may  be  managed  by  making  appropriate  choices  from  these  lists. 
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Window  Menu 

The  Windows  menu  enables  the  user  to  ereate  ID,  2D,  and  3D  viewports,  arrange  existing 
viewports,  and  view  individual  viewports  in  full  screen  mode.  Control  of  window  background 
colors  is  also  provided.  The  Window  menu  button  accesses  the  following  options. 

Create  ID  Viewport 

Activating  the  Create  ID  Viewport  option  will  create  a  new  plot  window.  The  ID  plot 
windows  are  designed  for  displaying  line  plots  of  data  created  by  science,  application,  or  data 
modules.  Note  that  the  Projection  option  of  the  Viewport  menu  can  be  used  to  change  the 
dimensionality  of  any  viewport  to  ID. 

Create  2D  Viewport 

Activating  the  Create  2D  Viewport  option  will  create  a  new  plot  window.  The  2D  plot 
windows  are  designed  for  projection  of  data  created  by  science,  application,  or  data  modules 
onto  a  2D  surface  (the  Earth’s  surface).  Note  that  the  Projection  option  of  the  Viewport  menu 
can  be  used  to  change  the  dimensionality  of  any  viewport  to  2D. 

Create  3D  Viewport 

Activating  the  Create  2D  Viewport  option  will  create  a  new  plot  window.  The  3D  plot 
windows  are  designed  for  display  of  3D  data  created  by  science,  application,  or  data 
modules.  Note  that  the  Projection  option  of  the  Viewport  menu  can  be  used  to  change  the 
dimensionality  of  any  viewport  to  3D. 

Background  Colors 

The  Background  Color  option  controls  background  color  of  the  active  viewport  which  can  be 
set  to  Black  (default).  Grey,  White,  or  another  arbitrary  color  using  the  Background  Color... 
option.  This  last  option  causes  a  Background  Color  popup  window  to  appear  containing  RGB 
and  HSV  color  sliders  and  a  color  wheel  option.  Move  the  sliders  or  simply  click  the  mouse 
pointer  on  the  color  wheel  to  select  the  corresponding  color. 

Full  Screen  (or  F8) 

The  Full  Screen  option  displays  the  contents  of  the  active  graphics  window  in  full  screen 
mode.  The  Esc  key  is  used  to  return  the  display  to  its  previous  state. 

Cascade 

The  Cascade  option  resizes  and  arranges  all  windows  in  an  overlapping  cascading  pattern 
with  the  highest  numbered  window  at  the  front. 

Tile 

The  Tile  option  resizes  and  shows  all  windows  and  completely  fills  the  graphics  portion  of 
the  GUI. 
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Arrange  Icons 

The  Arrange  Icons  option  organizes  all  minimized  graphics  windows  and  lines  them  up  at 
bottom  of  the  graphic  window  space. 

1:1,  2:2,  3:3, ... 

One  number  entry  appears  in  this  menu  for  each  active  window.  Numbers  are  assigned  in 
order  of  window  creation.  Select  a  number  to  bring  the  corresponding  window  to  the  front. 
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Viewport  Menu 

Split 

Activating  the  Split  option  will  divide  the  aetive  viewport  in  the  Horizontal  or  Vertical 
direction  such  that  two  viewport  windows  now  oeeupy  the  spaee  of  the  original  viewport. 

The  two  resulting  viewports  eontain  the  same  Projection  (see  next  entry)  of  the  original 
graphieal  objeet  set. 

Projection 

The  Projection  option  allows  the  projeetion  of  the  aetive  viewport  to  be  transformed  into  a 
one-dimensional  {One  D)  viewport,  a  two-dimensional  {Two  D)  viewport,  a  three- 
dimensional  {Three  D)  viewport,  a  speeial  three-dimensional  HelioSpace  viewport  used  to 
projeet  Paramesh  data,  or  a  speeial  Spectral  viewport  used  to  display  DMSP  partiele  data. 
Hint:  Use  the  Create  ID  Viewport  option  in  the  Window  menu  and  use  the  new  ID  window 
to  plot  results  if  the  existing  window  already  eontains  data.  Only  graphieal  objects 
appropriate  to  the  new  dimensionality  of  the  viewport  will  remain  viewable,  e.g.,  the  Earth, 
eoordinate  sliees,  and  satellite  orbits  will  remain  in  a  viewport  whose  projection  is  changed 
between  Two  D  and  Three  D,  but  none  will  appear  if  that  same  viewport  is  ehanged  to  One 
D.  In  this  latter  ease,  you  ean  quiekly  view  the  2D  or  3D  graphie  objeets  again  by  ehanging 
the  1-D  window  baek  into  2-D  or  3-D  and  redisplaying  the  existing  graphie  objeets.  To  do 
this,  seleet  Graphics  from  the  Modules  menu,  highlight  a  graphic  object  in  the  Active 
Modules  list  on  the  right  of  the  environment  window,  and  elick  Display. 

View  Position 

The  View  Position  option  is  used  to  set  the  eoordinate  frame  used  for  animating  Two  D  and 
Three  D  viewport  projeetions,  i.e.,  for  fixing  the  viewers  loeation  relative  to  a  seleeted 
eoordinate  systems.  The  ehoiees  are: 

GEOC,  GSM,  SM,  GEI:  Seleet  one  of  these  eoordinate  systems  to  fix  the  viewer’s 
perspeetive.  The  default  setting  is  GEOC,  i.e.,  the  viewer  remains  at  a  fixed  geographie 
loeation.  Definitions  of  these  eoordinate  systems  are  provided  in  the  Edit:  Grid  Tool  menu 
deseription  above. 

View:  The  View  option  sets  the  viewing  position  in  both  2D  and  3D  Viewports 

When  a  3D  viewport  is  aetive,  seleeting  the  View  option  results  in  a  View  Position  3D:  View 
popup  window  with  settings  for  tailoring  the  3D  view.  The  options  are: 

View  {Fixed,  Tracking) 

View  Positions  {Lat  Lon,  Noon,  Midnight,  Dawn,  Dusk,  UT,  North,  South,  Mag  North, 
Mag  South,  Satellite,  Sun) 

View  Position  Options  {Latitude,  Longitude,  UT) 

View  Up  {Longitude,  Noon,  Midnight,  Dawn,  Dusk,  UT,  North,  South,  Mag  North,  Mag 
South) 

When  a  2D  viewport  is  aetive,  seleeting  the  View  option  results  in  a  View  Position:  2D  View 
popup  window  with  settings  for  tailoring  the  2D  view.  The  options  are: 
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View  Options  {Fixed,  Tracking) 

View  Position  {Longitude,  Noon,  Midnight,  Dawn,  Dusk,  UT) 

View  Position  Options  {Longitude,  UT) 

Delete  (window) 

The  Delete  option  removes  the  active  portion  of  split  windows.  Use  the  close  button  at  the 
upper  right  of  each  viewport  to  delete  it  entirely,  but  note  that  the  last  remaining  viewport 
cannot  be  deleted. 

Color  Bar  Color 

The  Color  Bar  Color  option  controls  the  text  color  of  the  color  bar  labels.  This  option  causes 
a  Background  Color  popup  window  to  appear  containing  RGB  and  HSV  color  sliders  and  a 
color  wheel  option.  Move  the  sliders  or  simply  click  the  mouse  pointer  on  the  color  wheel  to 
select  the  corresponding  color. 

Color  Bar  Tics 

The  Color  Bar  Tics  option  is  used  to  adjust  the  number  of  minor  and  major  tic  marks 
appearing  along  the  color  bar  in  the  active  graphics  window.  Only  major  tic  marks  are 
labeled.  After  changing  the  number  of  tic  marks  in  the  popup  window,  update  the  color  bar 
by  either  placing  the  cursor  in  the  other  text  box  or  using  the  OK  button. 

Show  Color  Bar 

The  Show  Color  Bar  option  is  used  to  remove/replace  the  color  bar  appearing  on  the  right 
side  of  the  active  window. 

Perspective 

The  Perspective  option  changes  the  orthographic  projection  to  a  perspective  projection,  i.e.,  it 
shows  foreshortening. 
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Globals  Menu 


Show 

When  in  dynamic  mode  (after  both  a  Start  and  End  time  are  specified  and  Globals: Archive  is 
used)  the  Globals  menu  provides  read,  write,  and  save  access  to  the  global  parameters 
appropriate  to  the  selected  time  period.  A  Globals  popup  window  will  appear  showing  the 
parameters  Date,  Time,  Frac  Day,  Kp,  S_Kp,  Ap,  SSN,  FI 0.7,  Dst,  and  EqE.  See  the 
Global  Parameters  section  in  this  document  for  details  on  the  definitions  and  sources  for 
these  parameters.  These  values  can  be  edited  and  line  entries  can  be  added  or  deleted  directly 
in  the  text  window.  The  user  can  then  Apply  and  Save  changes  made.  Restore  the  original 
values  to  the  list,  or  Cancel  (close  the  window)  using  the  buttons  at  the  bottom  of  the  Globals 
window.  All  Science  and  Application  modules  run  will  utilize  this  same  set  of  global  input 
values  (see  individual  description  detailing  which  global  inputs  are  used  by  individual 
modules).  Note;  The  Globals  menu  is  inactive  when  running  in  static  mode,  i.e.,  when  only  a 
Start  time  is  specified.  In  static  mode,  the  global  parameters  used  to  represent  the  single 
selected  time  are  contained  in  the  Kp,  SSN,  El 0.7,  and  Ap  text  boxes  at  the  top  of  the 
Environment  window. 
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Help  Menu 

The  Help  menu  provides  aeeess  to  the  AF-GEOSpaee  User’s  Manual,  software  version  and 
point-of-eontaet  information. 

About  AF-GEOSpace 

Displays  version  number  and  point-of-eontaet  information. 

Manual 

Conneets  the  user  to  an  eleetronic  version  of  this  doeumentation  stored  in  the  direetory 
$AFGS_HOME\models\HELP 
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SCIENCE  MODULES 


Science  modules  provide  methods  for  generating  data  sets  from  various  models  of  the  spaee 
environment.  The  seience  modules  are  aecessed  through  the  seience  module  manager  that 
beeomes  visible  when  the  Science  option  in  the  Module  pulldown  menu  is  activated.  The  science 
module  manager  consists  of  two  lists  -  Available  Modules  and  Active  Modules.  Available 
Modules  are  all  the  modules  currently  supported  by  AF-GEOSpace.  Active  Modules  are  modules 
that  have  been  ereated  and  used  by  the  AF-GEOSpace  user  during  the  current  session. 

Initially,  the  scienee  module  manager  will  show  a  list  of  science  modules  under  Available 
Modules.  No  science  modules  have  yet  been  ereated,  so  the  Active  Modules  list  will  be  empty. 

Currently,  the  following  science  modules  are  supported  by  AF-GEOSpace: 

•  APEXRAD:  The  APEXRAD  space  radiation  dose  model  specifies  the  loeation  and  intensity 
of  the  radiation  dose  rate  behind  four  different  thicknesses  of  aluminum  shielding  for  five 
geomagnetic  activity  levels  as  specified  by  Apl5.  It  covers  the  Low  Earth  Orbit  (LEO) 
altitude  region  (360-2400  km)  and  was  developed  to  supplement  the  CRRESRAD  model  (see 
below)  whieh  has  limited  resolution  in  the  LEO  regime. 

•  AURORA:  The  auroral  preeipitation  model  speeifies  the  location  and  intensity  of  electron 
number  and  energy  flux,  ion  number  and  energy  flux,  Pederson  and  Hall  conductivities,  and 
the  equatorward  boundary  at  1 10  km  altitude.  This  module  also  provides  the  capability  to 
map  flux,  conductivity,  and  equatorial  boundary  values  up  magnetic  field  lines  into  the  three- 
dimensional  magnetospheric  grid. 

•  CAMMICE:  The  CAMMICE/MICS  model  of  the  inner  magnetosphere  plasma  population 
provides  pitch  angle  resolved  particle  fluxes  based  on  1-200  keV/q  ion  data  (H+,  He+,  He++, 
0<+3,  H,  He,  and  O)  collected  along  the  Polar  spaeeeraft  orbit  [1.8  x  9  Re  90°  inclination] 
from  1996-1999. 

•  CHIME :  The  CRRES/SP  ACERAD  Heavy  Ion  Model  of  the  Environment  (CHIME) 
speeifies  the  loeation  and  intensity  of  galactic  cosmic  rays  and/or  solar  energetic  particle 
fluxes  and/or  anomalous  cosmie  ray  fluxes. 

•  CRRESELE:  The  Combined  Radiation  and  Release  Effects  Satellite  (CURES)  eleetron  flux 
model  speeifies  the  location  and  intensity  of  electron  omnidirectional  flux  over  the  energy 
range  0.5-6. 6  MeV  for  a  range  of  geomagnetic  activity  levels. 

•  CRRESPRO:  The  Combined  Radiation  and  Release  Effeets  Satellite  (CURES)  proton  flux 
model  specifies  the  location  and  intensity  of  proton  omnidirectional  flux  over  the  energy 
range  1-100  MeV  for  quiet,  average,  or  active  geophysical  conditions. 

•  CRRESRAD:  The  Combined  Radiation  and  Release  Effects  Satellite  (CRRES)  space 
radiation  dose  model  speeifies  the  location  and  intensity  of  the  radiation  dose  rate  behind 
four  different  thieknesses  of  aluminum  shielding  for  aetive  or  quiet  geophysical  activity. 

•  CUTOFF:  The  Geomagnetie  Vertical  Cutoff  Rigidity  Interpolation  Model  (CUTOFF) 
provides  cutoff  rigidity  values  for  solar  protons  and  cosmic  rays,  as  a  function  of  the 
geomagnetie  activity  index  Kp,  for  altitudes  within  the  Earth’s  atmosphere  (>  20  km)  to 
beyond  geosynchronous  orbit. 
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GCPM:  The  Global  Core  Plasma  Model  of  2009  is  an  empirieal  deseription  of  thermal 
plasma  densities  (e-,  H+,  He+,  and  0+)  in  the  plasmasphere,  plasmapause,  magnetospherie 
trough,  and  polar  eap. 

lONSCINT:  The  High  Fidelity  lonospherie  Seintillation  Simulation  Algorithm  (lONSCINT) 
model  provides  realistie  scenarios  of  disruptions  in  trans-ionospheric  radio  wave 
communications  with  spacecraft  due  to  equatorial  scintillation.  lONSCINT  addresses  only 
intensity  (or  amplitude)  scintillation  of  244  MHz  signals  from  geosynchronous  satellites. 

lONSCINT-G:  The  GPS  Version  of  the  High  Fidelity  Ionospheric  Scintillation  Simulation 
Program  (lONSCINT-G)  provides  realistic  scenarios  of  disruptions  in  LI  frequency  trans- 
ionospheric  radio  wave  communications  with  spacecraft  due  to  equatorial  scintillation.  Sky- 
maps  of  the  S4  scintillation  index  are  generated  for  stationary  platform  locations. 

IRI2007:  The  International  Reference  Ionosphere  (IRI2007)  model  specifies  monthly 
averages  of  electron  density,  ion  composition,  electron  temperature,  and  ion  temperature  in 
the  altitude  range  50-1500  km. 

ISPM:  The  Interplanetary  Shock  Propagation  Model  predicts  the  transit  time  of 
interplanetary  shocks  from  the  sun  to  the  Earth  and  the  shock  strength  upon  arrival. 

MAGNETOPAUSE:  The  Magnetopause  Model  determines  if  a  given  point  lies  inside  or 
outside  of  the  model  magnetopause  boundary  and  determines  the  magnetopause  location 
closest  to  the  point  of  interest. 

METEOR  IMPACT  MAP:  The  Meteor  Impact  Map  Model  calculates  the  hourly  meteor 
impact  rate  or  damage  rate  for  a  given  cross  section,  pit  depth,  and  material  type  on  a  user- 
specified  surface  area  at  positions  outside  of  the  Earth's  atmosphere.  A  yearly  shower 
database  is  used  to  determine  the  active  showers,  their  intensity,  direction  of  travel,  and  mass 
distribution  characteristics. 

METEOR  SKY  MAP:  The  Meteor  Sky  Map  module  calculates  the  number  of  visible 
meteors  from  active  meteor  showers  (and  any  user-specified  storms)  at  the  specified  date, 
over  a  grid  of  ground-level  positions  covering  the  entire  globe. 

MSM  (Magnetospherie  Specification  Model):  The  Magnetospherie  Specification  Model 
(MSM)  module  generates  time-dependent  magnetic  field  values  as  well  as  electron,  H^,  and 
particle  fluxes  (100  eV  to  200  keV)  in  the  inner  and  middle  magnetosphere. 

NASAELE:  The  NASA  AE-8  radiation  belt  models  are  used  to  compute  the  intensity  and 
location  of  differential  omnidirectional  electron  flux  for  ten  energy  intervals  between  0.5  and 
6.6  MeV  which  correspond  to  the  ranges  of  the  CURES  HEEE  instrument. 

NASAPRO:  The  NASA  AP-8  radiation  belt  models  are  used  to  compute  the  intensity  and 
location  of  differential  omnidirectional  proton  flux  for  22  energy  intervals  between  1  and  100 
MeV  which  correspond  to  the  ranges  of  the  CURES  PROTEE  instrument. 

NRLMSISE-00:  The  NRLMSISE-00  empirical  model  computes  atmospheric  number 
densities  of  He,  O,  N2,  O2,  Ar,  H,  and  N,  plus  total  mass  density  and  temperature.  Anomalous 
oxygen  number  density,  i.e.,  hot  atomic  oxygen  (Oh)  or  atomic  oxygen  ions  (O"^)  present  at 
high  altitudes  (>  500  km),  and  exospheric  temperature  are  also  calculated. 
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PIM  (Parameterized  Ionospheric  Model):  A  global  ionosphere  model  generating  electron 
number  density  as  well  as  maps  of  total  electron  content  (TEC),  Height  of  E  and  E2  peaks 
(HE,  HE2),  and  plasma  frequencies  at  the  E  and  E2  peaks  (EoE,  EoE2)  as  a  function  of  a 
variety  of  geophysical  activity  indices. 

PPS  (Proton  Prediction  System):  Provides  forecasts  of  the  intensity  and  duration  of  solar 
proton  events. 

SAAMAPS-2007:  South  Atlantic  Anomaly  Maps  (SAAMAPS)  of  flux  intensities  for 
protons  (>  23,  >38,  >66,  and  >94  MeV)  were  created  for  the  epoch  2000-2006  based  on  data 
from  the  Compact  Environment  Anomaly  Sensor  (CEASE)  flown  onboard  the  TSX-5 
satellite  (410  km  x  1710  km,  69  degree  inclination  orbit). 

SEEMAPS-1998:  Normalized  flux  and  dose  data  for  protons  with  energy  >  50  MeV  from 
the  APEX  and  CRRES  satellites  were  used  to  produce  contour  maps  of  relative  probabilities 
of  experiencing  Single  Event  Effects  (SEEs)  in  the  Earth’s  inner  radiation  belts. 

STOA  (Shock  Time-of-Arrival  Model):  Predicts  the  transit  time  of  interplanetary  shocks 
from  the  sun  to  the  Earth.  STOA  is  a  predecessor  of  ISPM. 

TPM-1  (Trapped  Proton  Model):  The  Trapped  Proton  Model  (TPM-1)  provides  a  solar- 
cycle  dependent  low-altitude  extension  to  the  CRRESPRO  trapped  energetic  proton  model. 

WBMOD  (WideBand  Model):  An  RE  ionospheric  scintillation  model  specifying  S4,  SI, 
and  other  scintillation  parameters  between  any  location  on  the  globe  and  a  satellite  above  100 
km  altitude  at  any  frequency  above  100  MHz  as  a  function  of  a  variety  of  geophysical 
activity  indices. 
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Running  Science  Modules 

To  run  a  science  module,  use  the  mouse  to  select  the  Science  option  in  the  Module  pulldown 
menu  and  Available  Modules  and  Active  Modules  lists  will  appear  in  the  Environment  Window. 
Click  on  the  desired  choice  under  Available  Modules.  For  example,  to  create  a  new  version  of 
CRRESELE,  click  the  mouse  on  CRRESELE  in  the  Available  Modules  list.  Choosing  a  science 
module  will  do  two  things:  first,  the  choice  is  added  to  the  Active  Modules  list;  second,  the 
options  associated  with  the  chosen  science  module  will  appear  in  the  Environment  Window.  In 
general,  each  science  module  will  have  a  different  Environment  Window  representing  the 
module  specific  inputs.  Adjust  the  module  inputs  as  required.  Before  actually  running  the 
module,  the  following  two  adjustments  might  be  considered  which  can  effect  run  time  and  the 
size  of  the  output  files. 

First,  the  Grid  Tool  option  in  the  Edit  pulldown  menu  can  be  used  to  modify  the  grid  to  be  filled 
with  data  using  the  selected  science  module. 

Second,  the  Dynamic  Tool  option  in  the  Edit  pulldown  menu  can  be  used  to  adjust  both  the  time 
step  to  be  used  and  the  specific  output  parameters  to  be  calculated  if  a  Start  and  End  time  have 
been  set  at  the  top  of  the  window,  i.e.,  the  run  is  dynamic.  For  static  runs  only  a  Start  time  is 
specified  and  all  output  parameters  are  calculated  by  default. 

Finally,  the  Run/Update  option  in  the  Edit  pulldown  menu  is  used  to  run  or  re-run  the  module 
after  any  settings  have  been  changed.  When  the  module  run  is  complete  a  message  stating  that 
the  MODEE  IS  READY  AND  UP  TO  DATE  will  appear  in  the  Model  Status  box  at  the  bottom 
of  the  Environment  Window.  At  this  point,  the  data  produced  is  ready  for  display  using  graphical 
modules. 

Also,  the  Delete  option  in  the  Edit  pulldown  menu  is  used  to  remove  the  highlighted  science 
module  member  of  the  Active  Modules  list.  Note  that  all  active  graphics  objects  must  be  removed 
before  the  science  module  used  to  generate  their  data  can  be  removed. 
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The  APEXRAD  Science  Module 


Model  Name:  APEXRAD 

Version:  15  September  1997;  IGRF  updates  2009 

Developer:  Air  Force  Research  Faboratory  and  AER,  Inc. 

References:  Bell,  J.T.,  and  M.S.  Gussenhoven,  APEXRAD  Documentation,  PL-TR-97- 

2777(1997),  ADA  331633 

Gussenhoven,  M.S.,  E.G.  Mullen,  D.A.  Hardy,  D.  Madden,  E.  Holeman, 

D.  Delorey,  and  F.  Hanser,  Low  Altitude  Edge  of  the  Inner  Radiation  Belt: 
Dose  Models  from  the  APEX  Satellite,  IEEE  Trans.  Nucl.  Sci.,  42,  2035 
(1995) 

Gussenhoven,  M.S.,  E.G.  Mullen,  J.T.  Bell,  D.  Madden,  and  E.  Holeman, 
APEXRAD:  Low  Altitude  Orbit  Dose  as  a  Function  of  Inclination, 
Magnetic  Activity  and  Solar  Cycle,  IEEE  Trans.  Nucl.  Sci.,  44,2\6\ 
(1997) 

Hanser,  F.A.,  and  P.R.  Morel,  Analyze  Data  from  the  PASP  Plus 
Dosimeter  on  the  APEX  Spacecraft,  PL-TR-96-2088  (1996),  ADA  311336 

Mullen,  E.G.,  M.S.  Gussenhoven,  J.T.  Bell,  D.  Madden,  E.  Holeman,  and 
D.  Delorey,  Low  Altitude  Dose  Measurements  from  APEX,  CRRES,  and 
TIMS?,  Advances  in  Space  Res.,  21,  1651  (1997) 

Note:  It  is  recommended  that  AF-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

APEXRAD  Overview 

The  APEXRAD  module  is  a  PC  program  APEXRAD  developed  and  released  by  the  Air  Force 

Research  Laboratory.  APEXRAD  has  been  produced  to  supplement  the  higher  altitude 

CRRESRAD  dose  models.  The  following  description  of  APEXRAD  is  excerpted  from  the 

APEXRAD  Documentation: 

“APEXRAD  uses  empirical  models  based  on  data  from  the  APEX/P ASP+  dosimeter  to 
predict  the  amount  of  radiation  received  in  a  user  specified  orbit  behind  four  different 
aluminum  shielding  thicknesses.  The  Advanced  Photovoltaic  and  Electronics 
Experiments  (APEX)  Satellite  was  operational  from  3  Aug  94  to  2  Jun  96,  just  prior  to 
solar  minimum.  APEX  was  in  an  elliptical  orbit  with  a  70°  inclination,  a  perigee  of  362 
km  and  an  apogee  of  2544  km.  The  instrument  used  to  measure  accumulated  dose  was 
the  APEX  Space  Radiation  Dosimeter  which  measures  both  dose  rate  and  accumulated 
dose  in  four  silicon  detectors,  each  of  which  is  behind  an  aluminum  shield  of  a  different 
thickness  {Gussenhoven  etal.,  1995;  Gussenhoven  etal.,  1991',  Mullen  et  al,  1997).  One 
shield  was  a  4.28  mil  thick  slab  of  Al.  The  other  three  were  hemispheres  of  Al  with 
thicknesses  of  80.1,  225.8  and  444.4  mils.  [...]  The  minimum  energies  required  for 
particles  to  penetrate  the  shields  and  accumulate  dose  in  the  silicon  detectors  underneath 
are  0.15,  1,  2.5,  and  5  MeV  [respectively]  for  electrons  and  5,  20,  35,  and  50  MeV  for 
protons  [respectively]  {Hanser  and  Morel,  1996).  Dose  from  particles  depositing  0.05-1 
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MeV  and  1-10  MeV  is  accumulated  in  two  different  channels  ealled  LOLET  and  HILET 
respectively.  Contributions  to  HILET  dose  are  primarily  from  protons  with  energies  of  5- 
125  MeV,  but  eleetrons  with  energies  >5  MeV  may  eontribute  during  large  eleetron 
enhaneement  periods.  Contributions  to  LOLET  dose  are  from  eleetrons,  bremsstrahlung, 
and  protons  with  energies  >80MeV.  Dosimeter  data  are  available  for  approximately  14  of 
the  22  months  that  APEX  was  operational.” 

The  APEXRAD  seienee  module  is  used  to  map  the  radiation  dose  rate  models  from  the  APEX 
mission  into  a  three-dimensional  grid  speeified  by  the  user.  A  variety  of  magnetic  field  models 
ean  be  used  for  the  mapping.  Six  dose  rate  models  were  derived  from  the  APEX  data  as 
deseribed  by  the  following  exeerpt  from  the  APEXRAD  User’s  Manual: 

“The  dose  models  used  by  APEXRAD  are  based  on  in-situ  dose  rate  measurements  made 
on  board  the  APEX  satellite  [as  deseribed  in  the  exeerpt  above].  The  delta  dose  measured 
by  the  dosimeter  over  the  24-seeond  intervals  was  used  to  build  the  APEXRAD  models. 

A  baekground  subtraetion  is  performed  to  remove  the  dose  due  to  eonstant  sources, 
whieh  include  both  the  on-board  alpha  source  used  for  calibration,  and  cosmic  rays 
{Gussenhoven  et  al,  1997).  The  measured  dose  rates  for  eaeh  dome  were  binned  by  L 
and  B/BO  to  make  average  dose  rate  models  in  rads  (Si)  per  seeond.  The  width  of  eaeh 
bin  in  L  is  1/100  RE,  and  the  width  of  eaeh  bin  in  B/BO  is  one  degree  of  aersin  (B/BO)- 
1/2  (approximately  0.75”  latitude  in  a  dipole  field).  The  bins  form  a  two-dimensional 
array  of  500  (L)  by  90  (B/BO)  and  over  L  values  of  1  to  6  RE  and  magnetic  latitudes  of  0” 
to  -60”.  Many  of  these  bins  do  not  eontain  data  because  APEX  was  in  a  low  altitude  orbit 
and  only  reaehed  high  L  values  at  high  B/BO’s.  To  save  storage  spaee  most  of  the  empty 
data  bins  are  not  stored  as  part  of  the  models. 

Six  sets  of  APEXRAD  models  were  produced.  The  first  set  of  models  is  the  entire 
mission  average.  The  other  five  sets  of  models  are  based  on  the  Earth’s  magnetie  aetivity 
as  reeorded  by  Apl5,  a  fifteen  day  running  average  of  the  Ap  index.  The  loeation  and 
intensity  of  the  outer  belt  horns  is  dependent  on  the  magnetie  aetivity.  Higher  aetivity 
levels  eoincide  with  a  signifieant  increase  in  the  LOLET  dose  rate  (up  to  a  factor  of  10) 
where  the  boms  of  the  outer  belt  come  down  to  low  altitudes.  The  position  of  the  horns 
also  ohange[s]  with  magnetie  activity.  The  HILET  dose  rate  in  portions  of  the  inner  belt 
is  found  to  deerease  slightly  as  the  magnetie  aetivity  inereases,  however,  this  deerease  is 
small  (less  than  20  pereent  from  one  aetivity  level  to  the  next)  and  restrieted  to  the  inner 
edge  of  the  belt.  Thus  varying  magnetie  aetivity  has  negligible  effeet  on  the  HILET  dose 
predietions  for  most  orbits.  The  eumulative  effeet  of  varying  magnetie  aetivity  on  total 
dose  reeeived  will  depend  on  the  orbit.  Eor  orbits  that  pass  through  the  heart  of  the  inner 
belt[,  the]  dose  from  inner  belt  protons  will  dominate  the  total  dose  and  magnetic  activity 
will  have  little  impaet.  Eor  a  eertain  elass  of  low  altitude,  high  inelination  orbits, 
inereases  in  magnetie  aetivity  ean  lead  to  a  signifieant  inerease  in  total  dose  rate.” 

After  the  user  selects  which  data  model  is  desired,  the  APEXRAD  seienee  module  calculates  the 
B/L  eoordinates  of  eaeh  grid  point  from  the  user-speeified  magnetie  field  model.  The  resulting 
dose  rate  is  then  obtained  from  the  B/L  eoordinates  and  the  ehosen  data  model.  That  dose  rate  is 
assigned  to  the  grid  point.  In  this  manner  a  fully  three-dimensional  map  of  the  dose  rate  data  may 
be  made  from  the  APEX  data. 


35 

Approved  for  public  release;  Distribution  is  unlimited. 
AF-GEOSpace  User’s  Manual:  Version  2.5.1 


Warning:  Although  AF-GEOSpace  allows  the  data  to  be  mapped  in  three  dimensions  using  a 
variety  of  magnetie  field  models,  the  original  APEX  data  was  binned  into  B/L  eoordinates  using 
the  IGRE95  magnetic  field  model.  The  user  should  be  aware  that  using  other  magnetic  field 
models  to  map  the  data  into  three-dimensional  space  is  inconsistent  with  the  original  data 
reduction. 

APEXRAD  Inputs 

The  APEXRAD  science  module  requires  the  user  to  specify  the  combination  of  dosimeter 
particle  energy  ranges  and  aluminum  shielding  thickness  as  well  as  the  magnetic  activity  level 
and  the  magnetic  field  model  used  in  mapping  the  data. 

The  APEXRAD  options  are, 

B-Model:  The  magnetic  field  model  is  used  to  convert  from  the  B-E  coordinates  of 

the  model  to  three-dimensional  space.  The  default  is  the  field  model  used 
to  reduce  the  APEX  data  set:  IGRE95.  The  complete  options  are: 

Dipole:  A  dipole  field 

Dipole-Tilt:  A  tilted  dipole  field 

Dip-Tilt-Off:  A  tilted-offset  dipole  field 

IGRE:  The  International  Geomagnetic  Reference  Eield  with  no 

external  contributions. 

IGRF/O-P:  The  IGRF  internal  field  with  the  Olson  and  Pfitzer 

(1977)  static  model  to  represent  the  external  field. 

IGRF95:  The  International  Geomagnetic  Reference  Field  (1995) 

with  no  external  contributions. 

IGRF95/0-P:  The  IGRF95  internal  field  with  the  Olson  and  Pfitzer 

(1977)  static  model  to  represent  the  external  field. 

Shielding:  The  shielding  parameter  specifies  whether  the  4.29,  82.5,  232.5,  or  457.5 

mil  Al  hemisphere  shielding  thickness  data  set  is  to  be  used. 

Channel:  The  channel  parameter  specifies  which  dose  rate  data  set  is  to  be  used: 

Eo  Eet:  (0.05  -  1  MeV) 

HiEet:  (1-10  MeV) 

Total:  =  Lo  Let  +  Hi  Let 

Activity:  This  parameter  specifies  which  of  the  five  flux  model  sets  corresponding 

to  the  five  geomagnetic  activity  levels  as  specified  by  Apl5  is  to  be 
considered,  i.e.,  5.0  -  7.5,  7.5  -  10,  10  -  15,  15  -  20,  or  20  -  25.  Also 
possible  is  the  choice  of  the  mission  average  {Whole  Mission)  model  set. 

APEXRAD  Outputs 

The  APEXRAD  science  module  returns  a  3D  Gridded  Data  Set  of  the  dose  rate  in  units  of  rads 
(Si)  per  second  for  the  selected  shielding  level,  detector  channel,  and  activity  combination. 
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The  AURORA  Science  Module 


Model  Name:  Aurora 

Version:  September  1998 

Developer:  Air  Force  Research  Laboratory 

References:  Brautigam,  D.H.,  M.S.  Gussenhoven,  and  D.A.  Hardy,  A  Statistical  Study 

on  the  Effects  of  IMF  Bz  and  Solar  Wind  Speed  on  Auroral  Ion  and 
Electron  Precipitation,  J.  Geophys.  Res,  96,  5525-5538  (1991) 

Hardy,  D.A.,  W.  McNeil,  M.S.  Gussenhoven,  and  D.  Brautigam,  A 
Statistical  Model  of  Auroral  Ion  Precipitation  2.  Functional  Representation 
of  the  Average  Patterns,  J.  Geophys.  Res,  96,  5539-5547  (1991) 

Madden,  D.,  and  M.S.  Gussenhoven,  Auroral  Boundary  Index  from  1983 
to  1990,  GL-TR-90-0358,  Phillips  Eaboratory,  Hanscom  AFB,  MA  (1990), 
ADA  232845 

Hardy,  D.  A.,  M.S.  Gussenhoven,  and  D.  Brautigam,  A  Statistical  Model 
of  Auroral  Ion  Precipitation,  J.  Geophys.  Res.,  94,  370-392  (1989) 

Hardy,  D.  A.,  M.S.  Gussenhoven,  R.A.  Raistrick,  and  W.  McNeil, 
Statistical  and  Functional  Representations  of  the  Pattern  of  Auroral 
Energy  Flux,  Number  Flux,  and  Conductivity,  J.  Geophys.  Res.,  92, 
12275-12294  (1987) 

Hardy,  D.  A.,  M.S.  Gussenhoven,  and  E.  Holeman,  A  Statistical  Model  of 
Auroral  Electron  Precipitation,  J.  Geophys.  Res.,  90,  4229-4248  (1985) 

Gussenhoven,  M.S.,  D.A.  Hardy,  andN.  Heinemann,  Systematics  of  the 
Equatorward  Diffuse  Auroral  Boundary,  J.  Geophys.  Res.,  88,  5692-5708 
(1983) 

Gussenhoven,  M.S.,  D.A.  Hardy,  and  W.J.  Burke,  DMSP/F2  Electron 
Observations  of  Equatorward  Auroral  Boundaries  and  their  Relationship 
to  Magnetospheric  Electric  Fields,  J.  Geophys.  Res.,  86,  768-778  (1981) 

Note:  It  is  recommended  that  AF-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

AURORA  Overview 

The  AURORA  science  module  accesses  the  set  of  Air  Force  Statistical  Auroral  Models 
(AFSAM),  a  compilation  of  time  averaged  auroral  ion  and  electron  models.  These  models  were 
derived  from  precipitating  particle  measurements  made  by  the  SSJ/4  electrostatic  analyzers 
flown  on  the  F6  and  F7  satellites  of  the  Defense  Meteorological  Satellite  Program  (DMSP).  The 
SSJ/4  analyzers  determined  the  electron  and  ion  spectrum  in  the  local  satellite  zenith  direction 
once  per  second  over  20  channels  spanning  the  energy  range  from  30  eV  to  30  keV. 

Statistical  hemispheric  particle  precipitation  maps  were  created  for  a  range  of  different 
magnetospheric  activity  levels  using  the  same  spatial  grid  defined  in  corrected  geomagnetic 
latitude  (CGE)  and  magnetic  local  time  (MET).  The  high-latitude  region  grid  was  defined  by  30 
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zones  in  CGL  between  50”  and  90°  and  48  half-hour  zones  in  MLT.  The  latitude  zones  were  2° 
wide  between  50°  and  60°  and  1°  wide  between  60°  and  80°  latitude. 

For  a  given  level  of  activity,  one-second  spectra  were  accumulated  in  the  CGL  x  MLT  spatial 
grid  defined  above.  For  each  spatial  element,  the  average  value  of  precipitating  particle  flux 
(electrons  or  ions)  in  each  of  the  energy  channels  were  then  determined,  and  the  resulting 
average  spectra  extrapolated  to  100  keV.  The  large  size  of  the  DMSP  data  set  ensured  that  a 
reasonable  number  of  individual  1  -s  spectra  occurred  in  each  spatial  element  traversed  by  the 
satellite  such  that  a  statistically  meaningful  average  spectrum  could  be  determined.  From  these 
final  differential  number  flux  spectra,  a  number  of  key  parameters  were  derived,  including 
integral  number  flux,  integral  energy  flux,  average  energy  (ratio  of  integral  energy  flux  to 
integral  number  flux),  and  the  height-integrated  Hall  and  Pedersen  conductivities.  To  calculate 
the  conductivities,  we  used  the  functional  relations  of  Spiro  et  al.  [J.  Geophys.  Res.,  57,  8215, 
1982]  as  corrected  by  Robinson  et  al.  [J.  Geophys.  Res.,  92,  2565,  1987]. 

The  AFSAM  models  are  separated  according  to  (1)  the  magnetic  activity  index  Kp  and  (2)  the  z- 
component  of  the  interplanetary  magnetic  field  (IMF  Bz)  in  combination  with  the  solar  wind 
speed  (Vsw).  For  the  Kp  model,  there  are  7  maps  separated  by  whole  values  of  Kp,  i.e.,  one 
determination  for  Kp  =  0,  0+,  one  for  Kp  =  1-,  1,  1+,  etc.,  up  to  Kp=  5-,  5,  5+.  One  final 
separation  is  made  for  all  cases  with  Kp  >=  6-.  For  the  BzA^sw  model,  there  are  30  maps  defined 
by  the  paired  combinations  of  the  6  Bz  values  (-4.5,  -2.2,  -0.7,  0.7,  2.2,  4.5  nT)  and  the  5  Vsw 
values  (346,  408,  485,  572,  and  677  km/s). 

The  original  Kp  electron  model  [Hardy  et  al.,  1985]  was  constructed  using  data  from  the  older 
SSJ/3  spectrometers  flown  on  the  DMSP  F2  satellite  and  the  P78-1  satellite.  This  model  was 
followed  by  the  Kp  ion  model  [Hardy  et  al.,  1989]  which  was  constructed  using  data  from  the 
newer  SSJ/4  spectrometers  flown  on  DMSP  F6  and  F7  satellites.  For  consistency,  the  original  Kp 
electron  model  has  been  updated  by  a  newer  model  (identical  format)  constructed  from  the  same 
F6/F7  database  which  was  used  for  the  Kp  ion  model.  The  most  recent  AFSAM  models  are  the 
BzA^sw  models  for  both  electrons  and  ions  [Brautigam  et  al.,  1991]. 

AF-GEOSpace  uses  analytic  representations  of  the  key  parameters  derived  from  the  average 
spectra  and  noted  above.  At  this  point,  the  reference  for  the  analytical  fits  to  the  most  current 
models  has  not  yet  been  published  in  its  complete  form.  However,  the  original  reference  for  the 
Kp  ion  model  fits  to  integral  number  flux  and  integral  energy  flux  [Hardy  et  al.,  1991]  remains 
valid.  A  publication  referencing  the  complete  set  of  AFSAM  model  fits  is  forthcoming. 

The  output  domain  of  the  AFSAM  models  is  a  two-dimensional  (MLT,  CGL)  grid  located  at  1 10 
km  altitude  (1.017  Earth  radii).  The  default  output  grid  in  AE-GEOSpace  is  the  AESAM  two- 
dimensional  grid  mapped  to  three-dimensional  geocentric  coordinates  (GEOC)  at  an  altitude  of 
110  km  and  at  the  time  and  activity  level  specified  by  the  Global  Parameter  Kp  or  BzA^sw. 
Though  the  nominal  altitude  of  the  DMSP  satellites  is  840  km,  the  measured  fluxes  were  mapped 
down  the  magnetic  field  lines  to  1 10  km  (the  base  of  the  ionospheric  E  layer)  before  constructing 
the  AESAM  models. 

The  AE-GEOSpace  AURORA  science  module  extends  the  AESAM  models  by  providing  the 
capability  to  map  into  three  dimensions  the  magnetic  field  lines  that  intersect  constant  flux  or 
conductivity  contours  on  the  two-dimensional  model  grid.  This  is  done  as  follows:  for  each  grid 
point  in  the  user-specified  three-dimensional  grid,  the  unique  magnetic  field  line  intersecting  this 
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point  is  traced  down  to  the  original  two-dimensional  model  domain  at  1 10  km  using  a  user- 
speeified  magnetie  field  model.  The  grid  point  is  then  given  the  fiux  (integral  number  or  integral 
energy  fiux),  average  energy,  or  eonduetivity  value  existing  at  the  point  of  interseetion  between 
the  field  line  and  the  original  model  domain  at  1 10  km.  By  using  the  ISOCONTOUR  or 
COORD-SLICE  graphies  objeets  on  the  resultant  3D  AURORA  dataset,  magnetie  field  lines 
surfaees  interseeting  eontours  of  eonstant  fiux  in  the  original  model  domain  ean  be  easily 
visualized. 

Note:  The  value  of  the  flux,  average  energy,  or  eonduetivity  speeified  by  AF-GEOSpaee 
at  any  altitude  other  than  110  km  is  NOT  neeessarily  a  meaningful  value  for  that 
quantity.  AF-GEOSpace  uses  the  flux  values  on  the  three-dimensional  grid  above 
110  km  to  denote  sets  of  field  lines  emanating  from  the  respeetive  flux  value 
isocontours  at  1 10  km.  The  aetual  physieal  proeesses  involved  in  determining  the 
variation  of  fiux  values  along  the  magnetie  field  lines  have  not  been  eonsidered. 

Also  eontained  in  the  AURORA  seienee  module  is  an  algorithm  to  determine  the  equatorward 
boundary  of  the  aurora  at  1 10  km  altitude  and  map  it  along  field  lines  generated  by  a  user- 
speeified  magnetie  field  model.  The  algorithm  represents  a  linear  fit  between  the  equatorward 
boundary  (in  the  CGE  eoordinate)  of  the  eleetron  integral  number  flux  and  the  Kp  index  for  24 
seetors  in  MET  [Gussenhoven  et  al,  1981;  Gussenhoven  et  ai,  1983].  AF-GEOSpaee  uses  the 
eoefficients  determined  from  over  200,000  DMSP  boundary  erossings  in  the  interval  1983-1990 
[Madden  and  Gussenhoven  1990].  Options  are  given  to  either  (a)  input  Kp  and  output  the  entire 
equatorward  edge  boundary  or  (b)  input  a  single  observation  of  the  equatorward  edge  in  CGE 
and  MET  (e.g.,  from  one  DMSP  satellite  erossing)  and  output  the  entire  equatorward  edge 
boundary.  In  the  latter  ease,  an  “effective  Kp”  is  eomputed  by  inverting  the  linear  regression 
relation  for  the  measurement  in  the  single  MET  bin  and  then  using  the  effeetive  Kp  to  ealeulate 
the  equatorward  edge  in  the  remaining  MET  bins. 

AURORA  Inputs 

The  Aurora  seienee  module  requires  the  Global  Parameters:  Year,  Day,  UT,  and  Kp. 

Note:  When  a  3-D  grid  is  ehosen,  magnetie  field  model  inputs  neeessary  for  magnetie 
field  line  mapping  are  required  to  be  speeified  in  the  Internal  Field  and  External 
Field  seetions  outlined  below.  Additional  information  and  referenees  on  the 
magnetie  field  models  ean  be  found  in  the  BFIELD-APP  seetion  of  the 
doeumentation. 

The  Generate  seetion  allows  the  user  to  produee  the  following  output  data  sets: 

Gridded  Data:  A  set  of  3D  Gridded  Data  Sets  for  auroral  eleetron  number  flux,  eleetron 

energy  fiux,  ion  number  fiux,  ion  energy  flux,  eleetron  average  energy,  ion 
average  energy.  Hall  eonduetivity,  and  Pedersen  eonduetivity  is  produced. 
The  default  settings  for  the  Grid  define  a  two-dimensional  geoeentrie 
eoordinate  slice  at  the  eonstant  radius  of  1 10  km  (1.017  Re).  When  a 
three-dimensional  Grid  is  speeified  with  the  Grid  Tool,  the  data  values 
from  the  default  two-dimensional  shoe  are  mapped  to  the  grid  points  along 
field  lines  determined  from  the  user-speoified  magnetie  field  model. 
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Eq  Edge: 


Eield  Eine  data  sets  are  produeed  that  represent  the  equatorward  edge  of 
the  auroral  eleetron  number  flux  boundary  and  its  mapping  out  along 
magnetic  field  lines  of  the  user-specified  magnetic  field  model.  The 
following  options  become  applicable: 

Use  Kp  or  IME/SW  Model:  If  this  option  is  selected  the  AURORA 

science  module  calculates  the  equatorward  boundary 
using  the  Kp  or  IME/SW  option  described  below  in  the 
Model  section.  Eor  dynamic  runs,  Kp  inputs  are  those 
listed  using  the  Globals  menu  Show  option  while 
IME/SW  selections  remain  constant. 

Use  single  observation:  If  this  option  is  selected  the  AURORA  science 
module  calculates  the  equatorward  boundary  by 
determining  an  effective  Kp  from  a  single  MET 
observation  of  the  boundary  location.  The  effective  Kp 
is  then  applied  to  determine  the  boundary  for  the 
remaining  MET  points.  Eor  dynamic  runs,  the  selected 
settings  remain  fixed.  If  selected,  the  following 
quantities  must  be  entered, 

MET:  The  magnetic  local  time  of  the  observation 

in  decimal  hours. 

Observed  MEAT:  The  magnetic  latitude  in  Corrected 
Geomagnetic  Coordinates  of  the  observed 
equatorward  boundary  at  the  specified  MET. 
Typical  values  of  this  parameter  for 
midnight  local  time  (MET  =  0.0)  can  be 
viewed  using  the  Globals  menu  Show  option 
when  a  dynamic  run  is  performed. 

Note:  If  the  effective  Kp  determined  from  the  MLT,  Observed  MLAT  values  entered  is  outside 
of  the  acceptable  range  (Kp  =  0.0  to  9.0)  or  if  the  Observed  MLAT  value  entered  is  not 
valid  for  the  selected  MLT  value,  then  an  error  popup  window  will  warn  the  user.  To  best 
resolve  this,  select  the  Use  Kp  option  and  set  the  global  Kp  value  equal  to  either  0.0  or 
9.0,  whichever  is  appropriate. 

Map  from  North:  Magnetic  field  line  mapping  originates  from  the  auroral 
equatorward  boundary  in  the  northern  hemisphere. 

Map  from  South:  Magnetic  field  line  mapping  originates  from  the  auroral 
equatorward  boundary  in  the  southern  hemisphere. 

Note:  Magnetic  field  lines  emanating  from  the  northern  hemisphere  auroral  equatorward 
boundary  will  not  generally  match  those  emanating  from  the  southern  auroral 
boundary.  This  is  because  no  magnetic  field  model  in  AE-GEOSpace  exactly 
matches  the  models  used  to  construct  CGM  coordinates.  The  closest  match  arises 
when  using  the  IGRE  internal  field  for  the  year  1990  without  an  external  field. 
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The  match  is  not  exact  due  to  interpolation  and  function  fitting  of  the  CGM 
coefficients  in  the  CGM  to  geographic  coordinate  conversion  routine  used. 

The  Internal  B-Field  section  allows  the  user  to  specify  which  model  to  use  for  the  Earth’s 
internal  magnetic  field:  Dipole,  IGRF(1945-2010),  or  Fast  IGRF.  Additional  information  and 
references  on  the  magnetic  field  models  can  be  found  in  the  BFIELD-APP  section  of  the 
documentation. 

The  External  B-Field  section  allows  the  user  to  specify  which  model  to  use  for  external 
contributions  to  the  magnetic  field:  None,  Hilmer-Voigt,  Olson-Pfitzer,  Tsyganenko  ‘89,  or 
Tsyganenko  ‘87.  Additional  information  and  references  on  the  magnetic  field  models  can  be 
found  in  the  BFIEED-APP  section  of  the  documentation. 

The  Model  section  allows  the  user  to  specify  the  data  to  drive  the  model.  The  options  are: 

Kp:  Selects  the  Kp  index  from  the  Global  parameters  as  the  model  driver. 

IMF/S W:  Selects  the  interplanetary  magnetic  field  and  solar  wind  data  as  model 

driver.  When  this  option  is  chosen  the  following  quantities  must  be 
entered: 

Bz(nT):  The  value  of  the  z-component  of  the  interplanetary 

magnetic  field  available  as  six  selectable  values  from  - 
4.5  to  4.5  nanotesla  (nT). 

Vsw(km/s):  The  value  of  the  magnitude  of  the  solar  wind  velocity 

available  as  five  selectable  values  between  346  and  677 
kilometers/second  (km/s). 


AURORA  Outputs 

When  the  Gridded  Data  output  option  is  selected  the  AURORA  science  module  returns  the 
integral  electron  energy  flux  (keV/(cm  s  sr)),  the  integral  electron  number  flux  (#/(cm  s  sr)),  the 
integral  ion  energy  flux  (keV/(cm  s  sr)),  the  integral  ion  number  flux  (#/(cm  s  sr)),  the  electron 
average  energy  (keV),  the  ion  average  energy  (keV),  the  height-integrated  Pedersen  conductivity 
(mhos),  and  the  height-integrated  Hall  conductivity  (mhos)  as  separate  3D  Gridded  Data  Sets.  In 
the  default  mode,  the  3D  Gridded  Data  Set  will  contain  only  a  two-dimensional  constant  radius 
slice  at  an  altitude  of  1 10  km  (1.017  Re).  When  the  user  specifies  a  three-dimensional  grid  with 
the  Grid  Tool,  a  grid  point  is  assigned  a  value  equal  to  the  data  value  existing  at  the  point  of 
intersection  between  the  original  constant-radius  data  slice  at  1 10  km  and  the  magnetic  field  line 
that  maps  through  the  point  in  question.  It  is  thus  possible  to  denote  surfaces  of  field  lines 
emanating  from  separate  flux  value  isocontours  at  1 10  km. 

When  the  Eq  Edge  output  option  is  selected  the  AURORA  science  module  returns  a  Field  Fine 
Data  Set  containing  magnetic  field  lines  emanating  from  the  equatorward  edge  of  the  auroral 
electron  number  flux  (referred  to  as  Mapped  Eq.  Edge  in  the  data  selection  list).  An  additional 
Field  Fine  data  set  is  generated  representing  the  equatorward  edge  oval  (referred  to  as  Eq.  Edge). 
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The  CAMMICE  Science  Module 

CAMMICE 
August  2010 

AER,  Inc.  and  Air  Eorce  Research  Eaboratory  (based  on  partiele  flux 
database  fdes  provided  by  J.E.  Roeder  of  The  Aerospaee  Corporation) 

Olson,  W.P.,  and  K.A.  Pfitzer,  A  Quantitative  Model  of  the 
Magnetospherie  Magnetie  Eield,  J.  Geophys.  Res.,  79,  3739  (1974) 

Olson,  W.P.,  and  K.A.  Pfitzer,  Magnetospherie  Magnetie  Eield  Modeling, 
Annual  Seientifie  Report,  Air  Eoree  Offiee  of  Scientifie  Research  contract 
E44620-75-C-0033,  McDonnell  Douglas  Astronauties  Co.,  Huntington 
Beach,  CA  (1977),  ADA  037492 

Roeder,  J.E.,  M.W.  Chen,  J.E.  Eennell,  and  R.  Eriedel,  Empirieal  Models 
of  the  Eow-Energy  Plasma  in  the  Inner  Magnetosphere,  Space  Weather,  3, 
S12B06,  doi:10.1029/2005SW000161  (2005) 

Russell,  C.T.,  R.C.  Snare,  J.D.  Means,  D.  Pieree,  D.  Dearborn,  M.  Larson, 
G.  Barr,  and  G.  Le,  The  GGS/Polar  Magnetie  field  Investigation,  Space 
Set.  Rev.,  71,  563-582  (1995) 

Sehulz,  M.,  and  L.J.  Lanzerotti,  Particle  Diffusion  in  the  Radiation  Belts, 
Springer,  New  York,  (1974) 

Scudder,  J.,  et  ah.  Hydra — A  3-dimensional  eleetron  and  ion  hot  plasma 
instrument  for  the  Polar  spaeeeraft  of  the  GGS  mission.  Space  Sci.  Rev., 
71,  459-495  (1995) 

Note:  It  is  reeommended  that  AE-GEOSpaee  users  read  the  original  model 
doeumentation  and  deseriptive  articles  before  using  the  models. 

CAMMICE  Overview 

The  CAMMICE  scienee  module  provides  an  implementation  of  the  CAMMICE/MICS  empirieal 
plasma  flux  model  deseribed  hy  Roeder  et  al.  [2005]. 

“Data  from  two  instruments  on  the  Polar  satellite  [E8  x  9  Re  orbit  with  a  90°  inelination 
and  an  18-hour  period]  were  used  to  eonstruct  a  model  of  the  eharged  partiele 
environment.  The  Magnetospherie  Ion  Composition  Speetrometers  (MICS)  was  part  of 
the  Charge  and  Mass  Magnetospherie  Ion  Composition  Experiment  (CAMMICE)  on  the 
Polar  satellite.  MICS  measured  all  positively  eharged  ion  speeies  ranging  in  mass  from 
hydrogen  to  iron  in  the  range  1-200  keV/e.  [...]  The  CAMMICE/MICS  data  were 
supplemented  by  measurements  from  the  Hydra  instrument,  also  on  the  Polar  mission. 
Hydra  measured  ion  and  eleetron  flux  in  the  range  2  eV/e  to  35  keV/e  [Scudder  et  al., 
1995].” 

Multiple  equatorial  data  sets  were  derived  from  the  CAMMICE/MICS  data  as  deseribed  by  this 
additional  exeerpt  from  Roeder  et  al. : 


Model  Name: 

Version: 

Developer: 

Referenees: 
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“The  CAMMICE/MICS  data  for  3.5  years  (March  1996  to  September  1999)  were 
averaged  into  5 -min  distributions  in  energy  and  local  pitch  angle  to  build  the  database. 

The  24  energy  steps  from  the  MlCS  instrument  were  combined  into  12  channels  by 
averaging  the  fluxes  for  every  other  step  to  improve  statistics.  The  local  pitch  angles  for 
each  measurement  were  computed  using  the  simultaneous  data  from  the  Polar  magnetic 
field  experiment  \Russell  et  al,  1995].  The  local  pitch  angle  distribution  for  each  energy 
was  averaged  into  18  equally  spaced  bins  of  10°  widths.  Then  the  local  pitch  angles  were 
converted  into  equatorial  pitch  angles  using  the  ration  of  the  measured  local  magnetic 
field  magnitude  to  the  equatorial  magnetic  field  magnitude  [Schulz  and  Lanzerotti,  1974]. 

The  equatorial  magnetic  field  was  calculated  for  this  purpose  using  the  IGRF  model  of 
the  geomagnetic  field.  The  equatorial  pitch  angle  distribution  at  each  energy  was  then 
averaged  into  spatial  bins  in  equatorial  magnet  coordinates.  The  magnetic  equatorial 
plane  was  divided  into  a  grid  of  16  equally  space  bins  in  L  in  the  range  2-10  and  2-hour 
bins  in  MET.” 

An  additional  complete  set  of  data  files  were  also  created  by  the  authors  which  exclude  data 
obtained  during  geomagnetically  active  intervals,  i.e.,  to  represent  quieter  conditions  when  the 
geomagnetic  index  Dst  >  -100  nT. 

The  CAMMICE  module  is  used  to  map  the  ion  flux  data  sets  onto  a  three-dimensional  grid 
specified  by  the  user.  Two  different  magnetic  field  models  can  be  used  for  the  mapping.  After 
selecting  an  ion  species,  a  geomagnetic  Dst  activity  option,  and  a  pitch  angle  range  of  interest, 
the  module  calculates  the  B/L  coordinates  for  each  grid  point  in  the  user-specified  magnetic  field 
model.  Resulting  flux  values  are  then  obtained  from  the  B/L  coordinates  and  the  chosen  data  file 
and  assigned  to  the  grid  point.  In  this  manner,  a  fully  three-dimensional  map  of  the  ion  flux  data 
may  be  made  from  the  CAMMlCE/MlCS  equatorial  data  sets. 

CAMMICE  Inputs 

The  CAMMICE  science  module  requires  the  Global  Parameters:  Year,  Day,  and  UT. 

B-Model:  The  magnetic  field  model  used  to  convert  from  the  B-L  coordinates  of  the 

model  to  three-dimensional  space.  The  B-Model  options  include: 

IGRE:  The  International  Geomagnetic  Reference  Eield  with  no 

external  contributions. 

IGRE/O-P:  The  IGRF  internal  field  with  the  Olson  and  Pfitzer 

(1977)  static  model  to  represent  the  external  field. 

DST:  Two  ranges  of  geomagnetic  activity  can  be  specified,  namely 

All:  This  option  provides  results  of  the  complete  data  set. 

DST  >  -100:  This  option  presents  results  generated  from  data 

collected  when  the  Dst  index  was  less  negative  than  - 
100  nT,  i.e.,  during  only  geomagnetically  quieter 
conditions. 

Species:  The  particle  species  available  include:  H+,  He+,  He++,  0<+3,  H,  He,  O, 

and  Ions  (includes  all  ions  irrespective  of  mass  or  charge  state  and  are 
assumed  to  be  protons). 
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Pitch  Angle: 


The  equatorial  pitch  angle  distribution  options  inelude  Omnidirectional  or 
one  of  18  equally  spaeed  bins  of  10°  widths,  i.e.,  0-10,  10-20,  ...,  170-180 
degrees. 


CAMMICE  Outputs 

The  CAMMICE  Seienee  module  returns  a  3D  Gridded  Data  Set  of  the  partiele  flux  for  the 
selected  speeies  and  Dst  level  in  units  of  (#/cm^/s/keV)  in  the  following  12  energy  channels  all 
in  units  ofkeV/q:  (1)  [1.0-1. 3],  (2)  [1. 8-2.4],  (3)  [3 .2-4.2],  (4)  [5.6-7.4],  (5)  [9.9-13.2],  (6)  [17.5- 
23.3],  (7)  [30.9-41.1],  (8)  [54.7-72.8],  (9)  [80.3-89.7],  (10)  [100.1-111.7],  (11)  [124.7-139.1], 
and  (12)  [155.3-193.4].  The  L-Shell  and  B/Bo  values  used  to  determine  off-equator  fluxes  are 
also  returned. 

Note:  All  speeies  do  not  have  the  same  energy  eoverage  in  the  model,  therefore  partiele  fluxes 
for  the  following  [species,  energy  ehannel]  eombinations  are  not  part  of  the  CAMMICE 
Seienee  module  output:  [//+,  oh.1-3],  [He-t-,  ch.  1-5],  [0<+3,  oh.  1-6],  [H,  ch.  8-12],  [He, 
ch.  8-12],  and  [O,  oh.  9-12]. 
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The  CHIME  Science  Module  (Static  Only) 

CRRES/SPACERAD  Heavy  Ion  Model  of  the  Environment  (CHIME) 
3.5,  Deeember  1995 

Loekheed  Martin  Advaneed  Teehnology  Center  and  AFRL,  adapted  to 
AF-GEOSpaee  by  Radex,  Ine.  (now  AER,  Ine.) 

Chenette,  D.  L.,  J.D.  Tobin,  and  S.P.  Geller,  CRRES/SPACERAD  Heavy 
Ion  Model  of  the  Environment,  CHIME,  PL-TR-95-2152,  Phillips 
Laboratory,  Hanseom  AFB,  MA  (1995)  (User’s  guide  for  Version  3.5), 
ADA  321996 

Chenette,  D.L.,  J.  Chen,  E.  Clayton,  T.G.  Guzik,  J.P.  Wefel,  M.  Garcia- 
Munoz,  C.  Lopate,  K.R.  Pyle,  K.P.  Ray,  E.G.  Mullen,  D.A.  Hardy,  The 
CRRES/SPACRAD  Heavy  Ion  Model  of  the  Environment  (CHIME)  for 
Cosmie  Ray  and  Solar  Partiele  Effeets  on  Eleetronic  and  Biologieal 
Systems  in  Spaee,  IEEE  Trans.  Nucl.  Sci.,  41,  2332-2339  (1994) 

Feynman,  J.,  G.  Spitale,  J.  Wang,  and  S.  Gabriel,  Interplanetary  Proton 
Fluenee  Model:  JPL  1991,  J.  Geophys.  Res.,  98,  13281  (1993) 

Note:  It  is  reeommended  that  AF-GEOSpaee  users  read  the  original  model  doeumentation  and 
deseriptive  artieles  before  using  the  models. 

CHIME  Overview 

The  CRRES  Heavy  Ion  Model  of  the  near-Earth  Spaee  Environment  (CHIME)  Seience  Module 
and  Linear  Energy  Transfer  (LET)  Applieation  Module  are  based  on  the  PC  program  CHIME 
developed  and  released  under  the  auspiees  of  the  Air  Foree  Research  Laboratory.  The  following 
description  is  excerpted  from  the  CHIME  User’s  Manual: 

“[CHIME]  is  a  set  of  programs  and  data  files  which  permit  a  user  to  (1)  calculate  accurate 
models  of  the  fluxes  and  energy  spectra  of  ions  in  the  near-Earth  space  environment 
under  a  wide  variety  of  conditions,  (2)  convert  these  particle  flux  models  to  linear  energy 
transfer  spectra,  and  (3)  estimate  rates  for  single-particle  radiation  effects  in 
microelectronic  devices  exposed  to  the  environmental  model  fluxes....  The  [environment] 
model  covers  the  energy  range  from  10  MeV/nucleon  to  60  GeV/nucleon  for  all  known 
stable  elements,  and  includes  the  known  major  sources  of  heavy  ions  in  the  near-Earth 
interplanetary  medium  over  this  energy  range,  namely:  galactic  cosmic  rays  (GCR),  the 
anomalous  component  (AC),  and  heavy  ions  from  solar  energetic  particle  events  (SEP).” 

The  CHIME  Science  Module  calculates  ion  flux  models  (Step  1  in  the  paragraph  above)  and 
produces  a  3D  data  set  as  a  function  of  geographic  coordinates.  Calculation  of  the  LET  spectra 
and  single  event  effect  (SEE)  rates  (Steps  2  and  3  in  paragraph  above)  are  accomplished  in  the 
LET-APP  Module.  The  CHIME  Science  Module  provides  an  option  to  normalize  the  fluxes  to 
the  regular  CHIME  units  (particles/(m  s  sr  MeV/nucleon))  or  the  units  used  in  the  CRRESPRO 
trapped  proton  model  (particles/(m  s  MeV)).  Using  the  CRRESPRO  units,  intensities  of  the 
cosmic  rays  and  solar  energetic  particles  can  be  directly  compared  to  the  intensity  in  the 
radiation  belts. 


Model  Name: 

Version: 

Developer: 

References: 
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The  models  for  the  GCR  and  AC  are  deseribed  as  follows  in  the  CHIME  User’s  manual: 

“The  long-term  time-  and  energy-variations  of  the  GCR  and  AC  heavy  ions  near  earth  are 
well  understood  as  the  result  of  “modulation”  by  the  sun  of  a  set  of  “loeal  interstellar 
spectra”  (LIS)  defined  at  the  outer  boundary  of  the  heliosphere.  The  amount  of  this 
modulation  is  described  by  a  single  parameter  for  all  particle  species:  the  solar 
modulation  parameter,  O,  which  is  in  units  of  electric  potential,  typically  megavolts 
(MV). 

CHIME  contains  a  comprehensive  [GCR]  data  base  describing  the  heavy  ion  flux 
environment  near  earth  under  the  full  range  of  expected  solar  modulation  conditions.  This 
database  is  a  set  of  differential  (in  energy)  heavy  ion  fluxes  as  a  function  of  kinetic 
energy  (E)  and  O.  The  E,  O  range  covered  by  this  database  is  from  10  MeV/nucleon  to 
60  GeV/nucleon  in  kinetic  energy  and  300  MV  through  1700  MV  in  solar  modulation 
level.  All  ions  from  hydrogen  (Z=l)  through  nickel  (Z=28)  are  tabulated.  Ions  heavier 
than  nickel  are  modeled  using  abundance  ratios  to  iron.  [...] 

Eor  the  elements  He,  N,  O,  and  Ne  an  additional  component,  the  anomalous  component 
(AC),  is  also  tabulated  in  the  database.  The  AC  was  calculated  using  the  same  solar 
modulation  code  and  for  the  same  range  of  solar  modulation  as  the  GCR  flux.  Due  to  the 
nature  of  this  source,  however,  the  AC-LIS  decrease  very  rapidly  with  increasing  energy 
compared  to  the  GCR-LIS.  Thus  the  AC  fluxes  become  insignificant  compared  to  the 
GCR  fluxes  above  a  few  hundred  MeV  per  nucleon.  Additionally,  in  the  solar  modulation 
calculation  the  AC  was  treated  as  singly  charged,  and  the  AC  charge  state  is  assumed  to 
be  1  (singly  charged)  in  the  calculation  of  the  geomagnetic  shielding  [described  below].” 

Solar  Energetic  Particles  are  treated  in  a  variety  of  ways  as  described  in  the  CHIME  User’s 
Manual  excerpts  that  follow. 

“Several  different  SEP  models  are  incorporated  into  CHIME.  These  include  models 
based  on  measurements  made  during  the  CRRES  mission  and  models  based  on  statistical 
distributions  of  energetic  solar  proton  event  intensities.  The  user  of  CHIME  may  select 
any  one  of  these  models  to  add  to  the  GCR  and  AC  fluxes  determined  as  described 
[above].” 

“The  two  largest  SEP  events  observed  during  the  CRRES  mission  occurred  in  March  and 
June  1991.  Due  to  the  significance  of  these  events  to  CRRES  investigations,  they  are 
made  directly  available  for  use  in  CHIME.  The  March  event  was  an  “iron-rich”  event,  but 
with  a  significantly  softer  energy  spectrum  than  the  June  event  (see  Chen  et  al.  \Adv. 
Space.  Res.,  14,  675,  1994]  for  a  more  detailed  description  of  these  events).  Thus  for  very 
thin  amounts  of  passive  shielding,  the  March  environment  was  more  severe  than  that  for 
June....  The  user  can  select  the  peak  instantaneous  flux  or  the  highest  24-hour  average 
flux  for  either  event.” 

“Eor  predictive  purposes  CHIME  also  provides  heavy  ion  fiuence  models  as  a  function  of 
mission  duration  and  probability  of  occurrence.  (In  this  context  fiuence  refers  to  flux 
integrated  over  time.)  These  models  are  based  on  the  “Interplanetary  Proton  Eluence 
Model:  JPL  1991”  [Feynman  et  al,  1993].  This  is  a  statistical  description  of  the  observed 
distribution  of  energetic  solar  proton  event  sizes.  Eor  a  given  mission  start  date  and 
duration,  the  model  provides  a  proton  fiuence  spectrum  which  would  be  exceeded  at  a 

46 

Approved  for  public  release;  Distribution  is  unlimited. 

AF-GEOSpace  User’s  Manual:  Version  2.5.1 


probability  of  occurrence,  or  eonfidenee  level,  seleeted  by  the  user  (from  50%  to  0.1%). 
Heavy  ion  fluences  as  a  funetion  of  energy  are  sealed  from  the  proton  fluence  speetrum 
using  a  table  of  energy  independent,  average  solar  energetie  particle  event,  [and]  ion 
composition  factors. 

It  is  important  to  remember  that  the  JPL  1991  model  deseribes  ion  fluences,  which  are 
fluxes  integrated  over  a  speeifie  time  interval.  If  a  time  interval  is  speeified  by  the  user  in 
defining  the  GCR  and  AC  fluxes,  that  same  interval  will  be  used  in  the  SEP  model  if  the 
JPL  1991  model  is  selected.” 

To  compute  the  GCR,  AC,  and  SEP  partiele  fluxes  in  the  near-Earth  region  magnetieally 

shielded  by  the  Earth’s  magnetosphere  (taken  to  be  radial  distances  less  than  15  Earth  radii  in 

CHIME)  a  geomagnetic  cutoff  model  is  employed  as  described  in  the  CHIME  User’s  Manual: 

“The  model  is  based  on  an  offset,  tilted  dipole  approximation  for  the  earth’s  magnetic 
field  [Wilson  et  al,  NASA  Ref.  Pub.  1257,  475,  1991].  Despite  its  simplieity,  this  model 
eaptures  the  major  features  of  the  combined  total  average  geomagnetic  shielding  effeet 
with  good  aecuraey....  [Eor  eaeh  point  on  the  user-specified  grid  in  the  CHIME  science 
module],  the  GEOMAG  Transmission  funetion  in  CHIME  caleulates  the  aecess  solid 
angle  as  a  function  of  the  ion  energy  and  applies  this  filter  funetion  to  the  interplanetary 
heavy  ion  flux  calculated  by  the  proeedures  described  [above]...  The  transmission  filter  is 
applied  separately  to  the  GCR[+SEP]  and  AC  speetra.  While  the  GCR[+SEP]  source  is 
assumed  to  eonsist  of  fully  stripped  ions  (Q=Z),  the  AC  is  treated  as  singly  charged 
(Q=l)  in  this  part  of  the  ealculation.” 

Note:  The  CHIME  scienee  module  has  not  been  optimized  and  can  take  a  significant 
amount  of  run  time  on  high-resolution  grids. 

CHIME  Inputs 

Input  to  the  CHIME  science  module  comprises  the  environment  inputs  required  to  run  the  model 

and  the  requested  partiele  limits  for  the  output  fluxes. 

Specify  environment: 

GCR/AC  Elux  Input:  Several  methods  for  generating  cosmie  ray  fluxes  (Galaetie  Cosmic 

Rays/ Anomalous  Component  Speetra)  are  provided.  The  options  are: 

Off:  No  cosmie  ray  fluxes  generated. 

Modulation:  CHIME  provides  fluxes  eorresponding  to  the  Level 

(entered  in  the  text  box,  approximate  range:  400  to 
1600  megavolts)  of  solar  modulation  selected  from  a 
full  range  of  monthly  values  over  the  period  1970-2010. 

Period:  CHIME  computes  the  average  of  the  fluxes  for  eaeh  ion 

speeies  over  the  user-speeified  time  interval  entered  in 
the  Year  1,  Day  1,  Year  2,  and  Day  2  text  boxes 
aetivated  when  this  option  is  seleeted.  Tabulated 
monthly  values  of  the  solar  modulation  parameter  for 
the  period  1970-2010  are  used. 
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SEP  Events:  The  CHIME  model  provides  several  models  for  specifying  the  flux  or 

fluence  of  heavy  ions  originating  at  the  Sun  as  a  result  of  solar  energetic 
particle  (SEP)  events.  The  options  are: 

Off:  No  SEP  event  related  flux/fluence  is  generated. 

March  91  Peak:  Model  based  on  peak  CRRES  measurements  from  the 
March  1991  event 

June  91  Peak:  Model  based  on  peak  CRRES  measurements  from  the 

June  1991  event 

March  91  Ave:  Model  based  on  average  CRRES  measurements  from 
the  March  1991  event 

June  91  Ave:  Model  based  on  average  CRRES  measurements  from 

the  June  1991  event 

JPE  1991  Model:  Models  based  on  statistical  distributions  of  solar  proton 
event  intensities  (JPE  1991,  Feynmann  et  al.,  [1993]).  It 
provides  the  proton  fluence  that  would  be  exceeded  at  a 
probability  level  of  occurrence  {Pr),  or  confidence 
level,  from  50%  to  0.1%.  If  the  GCR/AC  Flux  option 
Off  or  Period  is  selected  above,  then  fluxes  are 
calculated  from  the  fluences  using  the  user-specified 
time  interval.  Modulation  is  selected  as  the  GCR/AC 
Flux  option,  then  a  random  period  of  1  year  is  used. 

Note:  The  cosmic  ray  flux  input  and  solar  event  options  are  identical  to  those  used  in  the 
EET-APP  Module. 

Galactic  cosmic  ray  (GCR)  and  solar  energetic  particles  (SEP): 

Atomic  Z(l-28):  The  range  (Min,  Max)  of  species  atomic  Z  value. 

Accepted  values  range  from  1  to  28  AMEl. 

Energy(MeV/n):  The  energy  range  (Min,  Max)  of  the  particles.  Accepted 
values  range  from  10  to  50000  MeV/n. 

The  Anomalous  component  cosmic  ray  (AC)  particles: 

Mass(4-20):  The  mass  range  (Min,  Max)  of  the  particles.  Accepted 

values  range  from  4  to  20  AMU. 

Energy(MeV/n):  The  energy  range  (Min,  Max)  of  the  particles.  Accepted 
values  range  from  10  to  2050  MeV/n. 

Elux  Units:  Two  proton  output  flux  unit  options  are  available.  Note  that  output  can  be 

displayed  using  either  units  without  re-running  the  CHIME  module  (see 
CHIME  Outputs  section  below  for  details).  The  options  are: 

CHIME:  Elux  is  given  in  units  of  #/(m^  s  sr  MeV/n). 

CRRESPRO:  Omni-directional  flux  is  given  in  units  #/(cm^  s  MeV/n). 
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CHIME  Outputs 

The  CHIME  science  module  outputs  a  3D  gridded  data  set  of  either  the  cosmic  ray  (and/or  solar 
event  fluxes)  or  the  anomalous  cosmic  ray  fluxes.  Output  units  are  #/(m^  s  sr  MeV/nucleon)  in 
CHIME  units  or  #/(cm^  s  MeV/nucleon)  in  CRRESPRO  units. 

Note;  After  generating  a  graphic  object  such  as  a  coordinate  slice,  you  can  view  output  in  the 
alternate  flux  units  by  doing  the  following:  return  to  the  CHIME  Science  Module  (i.e.,  go  to  the 
Module  Menu,  Science  option,  and  highlight  the  SciChime  entry  in  the  Active  Modules  list), 
reset  your  Flux  Units  selection,  (DO  NOT  rerun  CHIME),  return  to  the  graphics  object  to  be 
updated  and  then  reselect  the  CHIME  data.  Use  of  the  CRRESPRO  flux  unit  option  will  produce 
much  smaller  numbers  (factor  of  10'"^)  than  will  use  of  the  CHIME  flux  unit  option.  To  properly 
view  output  in  the  new  units,  the  color  scale  range  must  be  adjusted  using  the  Data  Map  options 
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The  CRRESELE  Science  Module 


CRRESELE 

July  1995;  IGRF  updates  2009 

Air  Force  Research  Laboratory  and  AER,  Inc. 

Brautigam,  D.H.,  and  J.  Bell,  CRRESELE  Documentation,  PL-TR-95- 
2128,  Phillips  Laboratory,  Hanscom  AFB,  MA  (1995),  ADA  301770 

Brautigam,  D.H.,  M.S.  Gussenhoven,  and  E.G.  Mullen,  Quasi-static 
Model  of  Outer  Zone  Electrons,  IEEE  Trans.  Nucl.  Sci.,  39,  1797-1803 
(1992) 

Brautigam,  D.H.,  CURES  in  Review:  Space  Weather  and  Its  Effects  on 
Technology,/,  of  Atmos.  And  Solar-Terr.  Phys.,  64,  1709-1721  (2002) 

Olson,  W.P.,  and  K.A.  Pfitzer,  Magnetospheric  Magnetic  Field  Modeling, 
Annual  Scientific  Report,  Air  Force  Office  of  Scientific  Research  contract 
F44620-75-C-0033,  McDonnell  Douglas  Astronautics  Co.,  Huntington 
Beach,  CA  (1977),  ADA  037492 

Note:  It  is  recommended  that  AF-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

CRRESELE  Overview 

The  CRRESELE  science  and  application  modules  use  the  PC  program  CRRESELE  developed 
and  released  by  the  Air  Force  Research  Laboratory.  The  following  description  of  CRRESELE  is 
excerpted  from  the  CRRESELE  documentation: 

“CRRESELE  utilizes  electron  radiation  belt  models  constructed  from  data  measured  by 
the  High  Energy  Electron  Fluxmeter  (HEEF)  flown  on  the  Combined  Release  and 
Radiation  Effects  Satellite  (CURES).  CRRES  flew  in  a  geosynchronous  transfer  orbit  for 
14  months  during  solar  maximum.  The  electron  models  are  omnidirectional  flux  maps 
binned  in  L  shell  and  B/BO  (azimuthal  symmetry  is  assumed)  for  a  given  energy.  The 
CRRESELE  utility  [uses  these  models]  to  calculate  electron  omnidirectional  fiuences 
(differential  or  integral)  for  10  energy  intervals  (0.5-6.60  MeV).  A  user-specified  orbit  is 
traced  through  eight  different  outer  zone  electron  flux  models,  at  each  energy,  to  provide 
an  estimate  of  electron  fiuences  received  by  a  satellite  under  a  wide  range  of 
magnetospheric  conditions.  Six  of  the  eight  CRRESELE  models  are  parameterized  by 
geomagnetic  activity  [using  the  Apl5  index],  the  seventh  is  simply  a  mission  average, 
and  the  eighth  is  constructed  from  maximum  flux  values.  Caution  must  be  used  when 
interpreting  the  results  [of  fiuence  calculations  using  the  electron  models]  because 
CRRESELE  is  restricted  to  modeling  the  outer  zone  electrons  [from  L=2.5-6.8]  and, 
consequently,  excludes  any  electron  fiuence  contributions  from  the  inner  zone  and  slot 
region.” 

Central  to  the  construction  of  the  CRRESELE  electron  models  is  the  new  geomagnetic  activity 
index,  Apl5,  defined  as  follows  in  the  CRRESELE  Documentation: 


Model  Name: 
Version: 
Developer: 
References: 
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“For  the  purpose  of  constructing  the  [CRRESELE  electron  flux  models]  we  define  a  new 
index  derived  from  the  Ap  value.  For  a  given  day,  the  preceding  15  daily  values  of  Ap 
are  averaged  to  form  the  Apl5  index.  The  Apl5  index  may  be  derived  from  either  the 
estimated  (NOAA-USAF  Space  Environment  Services  Center,  Preliminary  Report  and 
Forecast  of  Solar  Geophysical  Data)  or  archived  (NOAA  World  Data  Center- A,  Solar 
Geophysical  and  Prompt  Reports)  Ap  values;  the  results  agree  within  plus/minus  20% 
and  display  the  same  qualitative  variations.  A  linear  regression  was  performed  of  455 
days  of  estimated  and  archived  indices  and  yielded  the  following  linear  relation: 
Apl5(estimated)=  0. 8 *Ap  15 (archived)  +  2.6,  with  a  correlation  coefficient  of  0.99.  When 
Apl5  is  referred  to  in  this  document,  it  is  assumed  that  it  is  derived  either  directly  from 
the  weekly  estimated  Ap  or  indirectly  (via  the  linear  relationship  given  above)  from  the 
archived  version  of  Ap.” 

The  CRRESELE  science  module  is  used  to  map  the  electron  flux  models  used  by  CRRESELE 
into  a  three-dimensional  grid  specified  by  the  user.  A  variety  of  magnetic  field  models  can  be 
used  for  the  mapping.  The  eighty  electron  flux  models  used  in  CRRESELE  were  derived  from 
the  CURES  data  as  explained  by  the  following  excerpt  from  the  CRRESELE  Documentation, 

“The  0.512  second  count  rates  [from  each  of  the  10  energy  channels  of  the  HEEF 
instrument]  are  first  binned  by  L  (0.05  Re  bins)  and  pitch  angle  (5  degree  wide  bins), 
folding  the  pitch  angles  >  90  degrees  into  the  0-90  degree  quadrant.  Various  correction 
algorithms  are  next  applied  to  these  average  count  rates,  which  are  then  converted  to 
average  fluxes.  For  a  given  energy  and  L,  the  bin  average  pitch  angle  distributions  are 
mapped  to  the  magnetic  equator  [using  the  Olson-Pfitzer  static  external  magnetic  field 
model  and  the  IGRF85  internal  magnetic  field  model].  A  database  of  daily  average 
equatorial  fluxes  binned  by  day,  energy,  pitch  angle,  and  L  (2.5  <=  L  <=  6.55)  is  then 
created.  [The  data  are  then  extrapolated  to  L=6.68  by  using  a  linear  least-squares  fit  to  the 
data  from  L=6.0-6.55  for  each  equatorial  pitch  angle  bin  and  energy  channel.]  This 
database  is  next  sorted  into  eight  models...  Six  of  the  eight  models  are  parameterized  by 
geomagnetic  activity.  The  Apl5  index  [described  above]  is  determined  for  each  day  of 
the  CURES  mission  using  NOAA’s  weekly  published  values  for  the  estimated  daily 
planetary  index  (~Ap)  (SESC,  1990-1991)...  The  lowest  Apl5  values  represent  very  quiet 
magnetospheric  conditions,  during  which  one  can  expect  to  find  lower  fluxes  peaking  at 
higher  Ls.  Likewise,  the  highest  Apl5  values  represent  very  active  magnetospheric 
conditions,  during  which  one  can  expect  to  find  higher  flux  values  peaking  at  lower  L’s 
[Brautigam  et  al,  1992].  [...]  The  range  of  Apl5  observed  during  the  CRRES  period 
(Apl5  =  6  to  55)  is  divided  into  six  intervals  (5-7.5,  7.5-10,  10-15,  15-20,  20-25,  25-55). 
The  daily  average  flux  database  described  above  is  then  sorted  according  to  the 
corresponding  daily  Apl5  value.  [...]  This  procedure  results  in  six  electron  equatorial  flux 
models  for  each  of  the  10  energies.  [...]  Two  additional  models,  independent  of  Apl5,  are 
constructed  from  the  same  average  flux  database  referred  to  above.  For  [the  first 
additional  model]  the  entire  database  is  averaged  together  providing  a  mission  averaged 
model.  [The  second  additional  model]  is  constructed  from  the  maximum  flux  found  at 
each  L  bin  of  the  daily  averages.” 

After  the  user  selects  a  flux  model,  the  CRRESELE  science  module  calculates  the  B/L 
coordinates  for  each  grid  point  in  the  user-specified  magnetic  field  model.  The  resulting  flux  is 
then  obtained  from  the  B/L  coordinates  and  the  chosen  data  file  and  then  assigned  to  the  grid 
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point.  In  this  manner,  a  fully  three-dimensional  map  of  the  outer  zone  flux  data  may  be  made 
from  the  CRRES  data. 

Note;  Although  AF-GEOSpaee  allows  the  data  to  be  mapped  in  three  dimensions  using 
a  variety  of  magnetie  field  models,  the  original  CRRES  data  was  binned  into  B/L 
eoordinates  using  the  IGRF85  magnetie  field  with  the  Olson-Pfitzer  (1977) 
external  field.  The  user  should  be  aware  that  using  other  magnetie  field  models  to 
map  the  data  to  three-dimensional  spaee  is  ineonsistent  with  the  original  reduetion 
of  the  data. 


CRRESELE  Inputs 

The  CRRESELE  seienee  module  requires  the  user  to  speeify  the  following  information  to 
determine  whieh  data  set  to  use  and  whieh  magnetie  field  model  to  use  in  mapping  the  data, 

B-Model:  The  magnetie  field  model  used  to  eonvert  from  the  B-L  eoordinates  of  the 

model  to  three-dimensional  spaee.  While  the  model  used  to  reduee  the 
CRRES  data  was  IGRF85/0-P,  the  default  setting  uses  IGRF/O-P.  The  B- 
Model  options  inelude; 


Dipole: 

Dipole-Tilt: 

Dip-Tilt-Off: 

IGRF: 

IGRF/O-P: 

IGRF85; 


A  dipole  field 
A  tilted  dipole  field 
A  tilted-offset  dipole  field 

The  International  Geomagnetie  Referenee  Field  with  no 
external  eontributions  (Extrapolation  beyond  2010). 

The  IGRF  internal  field  with  the  Olson  and  Pfitzer 
(1977)  statie  model  to  represent  the  external  field. 

The  International  Geomagnetie  Referenee  Field  (1985) 
with  no  external  eontributions. 


IGRF85/0-P:  The  IGRF85  internal  field  with  the  Olson  and  Pfitzer 

(1977)  statie  model  to  represent  the  external  field.  The 
original  CRRES  data  was  redueed  using  this  option. 

Note:  The  IGRF85  internal  field  uses  the  Year,  Day,  and  UT  Global  Parameters. 

Although  less  eonsistent  with  the  original  data  reduetion,  models  are  eomputed 
signifieantly  faster  when  one  of  the  dipole  field  options  is  ehosen. 

Energy  Channel  (MeV):The  energy  ehannel  parameter  seleets  whieh  of  the  ten  flux  models 

eorresponding  to  the  ten  HEEF  energy  ehannels  with  eentral  energies 
between  0.65  and  5.75  MeV  is  to  be  eonsidered.  The  ehannel  numbers 
and  assigned  limits  are  listed  here.  The  Ecentrai  column  eorresponds  to  the 
Energy  Channel  options  shown  in  the  Environment  Window: 


CH 

Elower 

Ecentrai 

r^upper 

AE 

0 

0.50 

0.65 

<0.80 

0.30 

1 

0.85 

0.95 

<1.05 

0.20 

2 

1.25 

1.60 

<1.70 

0.45 

3 

1.70 

2.00 

<2.10 
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4 

2.10 

2.35 

<2.50 

0.40 

5 

2.50 

2.75 

<2.90 

0.40 

6 

2.90 

3.15 

<3.30 

0.40 

7 

3.30 

3.75 

<4.10 

0.80 

8 

4.10 

4.55 

<4.95 

0.85 

9 

4.95 

5.75 

<6.60 

1.65 

Apl5  Model  Range:  This  parameter  speeifies  whieh  of  the  six  flux  model  sets  corresponding  to 
the  six  geomagnetic  activity  levels  (Apl5  =  5. 0-7. 5,  7.5-10.0,  10.0-15.0, 
15.0-20.0,  20.0-25.0,  or  25.0-55.0)  is  to  be  considered.  Mission  average 
(A  VE)  and  mission  maximum  {MAX)  model  sets  are  also  available. 

Global  Apl5:  Pushing  the  Compute  button  causes  an  automatic  calculation  of  the  15-day 

average  of  the  Ap  index  (Apl5)  based  on  the  chosen  global  parameter  set, 
i.e.,  ^xov^\  Archive,  Prelim,  ox  Latest,  and  displays  the  value  in  the  window. 
If  the  parameter  records  are  insufficient  to  compute  Apl5  then  the  value 
will  be  labeled  as  missing. 

CRRESELE  Outputs 

The  CRRESELE  science  module  returns  a  3D  Gridded  Data  Set  of  the  electron  flux  for  the 
selected  energy  channel  and  activity  level  (including  A  VE  and  MAX)  in  units  of  #/(cm^  s  keV). 
Note  that  the  “model  #”  and  “eh  #”  reported  in  the  Model  Status  box  correspond  to  the  selected 
Apl5  Model  Range  and  Energy  Channel  (MeV)  values,  respectively.  For  example,  model  #1 
corresponds  to  Apl5  Model  Range  “Apl5  7.5-10.0”  and  eh  #2  corresponds  to  Energy  Channel 
(MeV)  “0.95”. 
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The  CRRESPRO  Science  Module 


CRRESPRO 

28  July  1994;  IGRF  updates  2009 
Air  Force  Research  Laboratory  and  AER,  Inc. 

Meffert,  J.D.,  and  M.S.  Gussenhoven,  CRRESPRO  Documentation,  PL- 
TR-94-2218,  Phillips  Laboratory,  Hanscom  APB,  MA  (1994),  ADA 
284578 

Gussenhoven,  M.S.,  E.G.  Mullen,  M.D.  Violet,  C.  Hein,  J.  Bass,  and  D. 
Madden,  CRRES  High  Energy  Proton  Plux  Maps,  IEEE  Trans.  Nucl.  Sci., 
40,  1450-1457  (1993) 

Olson,  W.P.,  and  K.A.  Pfitzer,  Magnetospheric  Magnetic  Pield  Modeling, 
Annual  Scientific  Report,  Air  Porce  Office  of  Scientific  Research  contract 
P44620-75-C-0033,  McDonnell  Douglas  Astronautics  Co.,  Huntington 
Beach,  CA  (1977),  ADA  037492 

Note;  It  is  recommended  that  AP-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

CRRESPRO  Overview 

The  CRRESPRO  science  and  application  modules  are  based  on  the  PC  program  CRRES-PRO 
developed  by  the  Air  Porce  Research  Eaboratory.  Note  that  the  TPM-1  Science  Module, 
described  elsewhere  in  this  document,  is  a  low-altitude  extension  of  the  CRRESPRO  model.  A 
CRRESPRO  Documentation  excerpt: 

“CRRESPRO  predicts  proton  omnidirectional  fluence  per  year  and  integral 
omnidirectional  fluence  per  year  at  selected  energies  in  the  range  1-100  MeV  for  an  orbit 
specified  by  the  user.  It  closely  parallels  its  counterpart,  CRRESRAD,  which  predicts 
dose  behind  four  thicknesses  of  hemispherical  aluminum  shielding.  [...]  The  CRRESPRO 
software  uses  flux  models  created  from  data  collected  by  the  proton  telescope  (PROTEE) 
on  board  the  Combined  Release  and  Radiation  Effects  Satellite  (CRRES)  flown  from  25 
July  1990  to  12  October  1991  during  solar  maximum.  CRRES  was  in  a  geosynchronous 
transfer  orbit  with  an  inclination  of  18  degrees,  a  perigee  of  350  km,  and  an  apogee  of 
33000  km.  It  traversed  the  radiation  belts  twice  per  orbit  with  a  period  of  9  hours  52 
minutes.  In  March  1991,  a  magnetic  storm  caused  a  reconfiguration  of  the  inner 
magnetosphere,  resulting  in,  among  other  features,  double  proton  belts  forming  over  a 
certain  energy  range.  Because  of  this  change,  two  CRRES  models  were  created.  The 
quiet  model  uses  data  from  July  1990  to  March  1991,  and  the  active  model  uses  data 
from  March  1991  to  October  1991.  Note  that  in  this  documentation  and  the  CRRESPRO 
software,  “quiet”  refers  to  the  period  from  July  1990  to  March  1991  (single  proton  belt) 
and  “active”  refers  to  March  1991  to  October  1991  (double  proton  belt).  Quiet  and  active 
as  used  here  for  the  inner  radiation  belt  have  no  correspondence  to  quiet  and  active  as 
determined  by  Kp.  In  fact,  the  average  Kp  for  the  two  CRRES  periods  was  the  same, 
namely  2.2.” 


Model  Name: 
Version: 
Developer: 
References: 
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The  CRRESPRO  science  module  is  used  to  map  the  proton  flux  data  sets  used  by  CRRESPRO 
onto  a  three-dimensional  grid  specified  by  the  user.  A  variety  of  magnetic  field  models  can  be 
used  for  the  mapping.  Forty-four  data  sets  were  derived  from  the  CRRES  data  as  described  by 
the  following  excerpt  from  the  CRRESPRO  documentation: 

“The  flux  models  used  by  CRRESPRO  are  based  on  in  situ  flux  measurements  made  by 
CRRES.  [...]  The  instrument  used  to  measure  flux  on  CRRES  was  the  proton  telescope 
(PROTEL).  PROTEL  had  two  detector  heads,  which  together  measured  protons  from  1  to 
100  MeV  in  24  energy  steps,  giving  a  complete  spectrum  every  1.024  seconds.  The 
angular  resolution  of  the  detector  low  (high)  energy  head  was  +/-  10  degrees  by  +/-  10 
degrees  (+/-  12  degrees  by  +/-  17  degrees).  [...]  For  the  CRRES  proton  models,  a  data 
base  of  differential  number  flux  values  on  the  magnetic  equatorial  plane  was  created 
using  each  PROTEL  data  point.  The  in  situ  values  were  mapped  point  by  point  to  the 
magnetic  equator  conserving  the  first  adiabatic  invariant  in  the  combined  IGRF85  and 
Olson-Pfitzer  quiet  magnetic  field  model.  The  equatorial  data  were  averaged  by  channel 
for  each  leg  of  each  orbit  in  L  shell  bins  of  extent  l/20th  Re  and  pitch  angle  bins  of  width 
5  degrees.  The  equatorial  data  from  all  orbits  occurring  before  (after)  the  March  1991 
storm  were  then  combined  in  the  same  L  and  pitch  angle  bins  to  create  the  CRRES  quiet 
(active)  proton  model.  [...]  In  summary,  we  have  created  two  proton  models  from  the 
CRRES  PROTEL  data  base:  a  quiet  model  using  data  acquired  before  the  March  1991 
storm  and  an  active  model  using  data  acquired  after  the  storm.  Each  model  potentially 
consists  of  twenty-four  sub  models,  one  for  each  energy  channel.  [...]  We  eliminate  one 
of  the  8.5  MeV  channels  and  the  15.2  MeV  channel  [see  full  documentation  for 
discussion].  This  results  in  44  different  flux  model  files.” 

After  selecting  a  proton  data  set,  the  module  calculates  the  B/L  coordinates  for  each  grid  point  in 
the  user-specified  magnetic  field  model.  Resulting  flux  values  are  then  obtained  from  the  B/L 
coordinates  and  the  chosen  data  file  and  assigned  to  the  grid  point.  In  this  manner,  a  fully  three- 
dimensional  map  of  the  proton  flux  data  may  be  made  from  the  CRRES  data. 

Note:  Although  AF-GEOSpace  allows  the  data  to  be  mapped  in  three  dimensions  using 
a  variety  of  magnetic  field  models,  the  original  CRRES  data  was  binned  into  B/L 
coordinates  using  the  IGRF85  magnetic  field  with  the  Olson  and  Pfitzer  (1977) 
external  field.  The  user  should  be  aware  that  using  other  magnetic  field  models  to 
map  the  data  to  three-dimensional  space  is  inconsistent  with  the  original  reduction 
of  the  data. 

CRRESPRO  Inputs 

The  CRRESPRO  science  module  requires  the  user  to  specify  the  following  information  to 
determine  which  data  set  to  use  and  which  magnetic  field  model  to  use  in  mapping  the  data, 

B-Model:  The  magnetic  field  model  used  to  convert  from  the  B-L  coordinates  of  the 

model  to  three-dimensional  space.  While  the  model  used  to  reduce  the 
CRRES  data  was  IGRF85/0-P,  the  default  setting  uses  IGRF/O-P.  The  B- 
Model  options  include: 

Dipole:  A  dipole  field 

Dipole-Tilt:  A  tilted  dipole  field 
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Dip-Tilt-Off: 

A  tilted-offset  dipole  field 

IGRE: 

The  International  Geomagnetic  Reference  Field  with  no 
external  contributions  (Extrapolation  beyond  2010). 

IGRE/O-P: 

The  IGRF  internal  field  with  the  Olson  and  Pfitzer 
(1977)  static  model  to  represent  the  external  field. 

IGRE85: 

The  International  Geomagnetic  Reference  Field  (1985) 
with  no  external  contributions. 

IGRF85/0-P: 

The  IGRF85  internal  field  with  the  Olson  and  Pfitzer 
(1977)  static  model  to  represent  the  external  field.  The 
original  CURES  data  was  reduced  using  this  option. 

Note:  The  IGRF85  internal  field  uses  the  Year,  Day,  and  UT  Global  Parameters. 

Although  less  consistent  with  the  original  data  reduction,  models  are  computed 
significantly  faster  when  one  of  the  dipole  field  options  is  chosen. 

Energy  Channel  (MeV);The  energy  channel  parameter  selects  which  of  the  proton  flux  data  sets 

corresponding  to  the  twenty-two  PROTEL  energy  channels  between  1  and 
100  MeV  is  to  be  considered.  The  Ecentrai  column  corresponds  to  the 
Energy  Channel  options  shown  in  the  Environment  Window: 


CH 

Elower 

Ecentrai 

^.^upper 

AE 

1 

1.1 

1.5 

1.9 

0.8 

2 

1.9 

2.1 

2.3 

0.4 

3 

2.3 

2.5 

2.7 

0.4 

4 

2.7 

2.9 

3.1 

0.4 

5 

3.1 

4.3 

5.5 

2.4 

6 

5.5 

5.7 

5.9 

0.4 

7 

5.9 

6.8 

7.7 

1.8 

8 

7.7 

8.5 

9.3 

1.6 

9 

9.3 

9.7 

10.1 

0.8 

10 

10.1 

10.7 

11.3 

1.2 

11 

11.3 

13.2 

15.1 

3.8 

12 

15.1 

19.4 

23.7 

8.6 

13 

23.7 

26.3 

28.9 

5.2 

14 

28.9 

30.9 

32.9 

4.0 

15 

32.9 

36.3 

40.2 

7.3 

16 

40.2 

41.1 

43.2 

3.0 

17 

43.2 

47.0 

50.8 

7.6 

18 

50.8 

55.0 

59.2 

8.4 

19 

59.2 

65.7 

72.2 

13.0 

20 

72.2 

81.3 

90.4 

18.2 

Activity:  The  activity  parameter  specifies  whether  the  Quiet  (obtained  before  the  24 

March  1991  storm)  ox  Active  (obtained  after  the  24  March  1991  storm) 
proton  flux  data  sets  are  to  be  used. 
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CRRESPRO  Outputs 

The  CRRESPRO  Science  module  returns  a  3D  Gridded  Data  Set  of  the  proton  flux  for  the 
selected  energy  channel  and  activity  level  in  units  of  #/(cm^  s  MeV). 
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The  CRRESRAD  Science  Module 

CRRESRAD 

August  1992;  IGRF  updates  2009 
Air  Force  Research  Laboratory  and  AER,  Inc. 

Kearns,  K.J.,  and  M.S.  Gussenhoven,  CRRESRAD  Documentation,  PL- 
TR-92-2201 ,  Phillips  Laboratory,  Hanscom  AFB,  MA  (1992),  ADA 
256673 

Gussenhoven,  M.S.,  E.G.  Mullen,  M.  Sperry,  K.J.  Kerns,  and  J.B.  Blake, 
The  Effect  of  the  March  1991  Storm  on  Accumulated  Dose  for  Selected 
Satellite  Orbits:  CRRES  Dose  Models,  IEEE  Trans.  Nuc.  Sci.,  29,  1765- 
1772  (1992) 

Gussenhoven,  M.S.,  E.G.  Mullen,  D.H.  Brautigam,  E.  Holeman,  C. 

Jordan,  E.  Hanser,  and  B.  Dichter,  Preliminary  Comparison  of  Dose 
Measurements  on  CRRES  to  NASA  Model  Predictions,  IEEE  Trans.  Nucl. 
Sci,  38,  1655-1662 (1991) 

Olson,  W.P.,  and  K.A.  Pfitzer,  Magnetospheric  Magnetic  Eield  Modeling, 
Annual  Scientific  Report,  Air  Force  Office  of  Scientific  Research  contract 
F44620-75-C-0033,  McDonnell  Douglas  Astronautics  Co.,  Huntington 
Beach,  CA  (1977),  ADA  037492 

Note:  It  is  recommended  that  AF-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

CRRESRAD  Overview 

The  CRRESRAD  application  is  based  on  the  PC  program  CRRESRAD  developed  and  released 

by  the  Air  Eorce  Research  Laboratory.  A  CRRESRAD  Documentation  excerpt: 

“CRRESRAD  predicts  the  amount  of  radiation  received  in  a  specified  orbit  behind  four 
hemispheres  of  aluminum  with  thicknesses  of  82.5,  232.5,  457.5,  and  886.5  mils.  The 
prediction  uses  empirical  models  of  accumulated  dose  measured  on  the  Combined 
Release  and  Radiation  Effects  Satellite  (CRRES)  flown  from  25  July  1990  to  12  October 
1991  during  solar  maximum.  CRRES  was  in  a  geosynchronous  transfer  orbit  with  an 
inclination  of  18  degrees,  a  perigee  of  350  km  and  an  apogee  of  33000  km.  CRRES 
traversed  the  radiation  belts  twice  per  orbit  with  a  period  of  9  hours  52  minutes.  The 
instrument  used  to  measure  accumulated  dose  is  the  CRRES  Space  Radiation  Dosimeter 
which  measures  both  dose  rate  and  accumulated  dose  in  four  silicon  detectors  each  of 
which  is  behind  an  aluminum  dome  of  different  thickness.  The  minimum  energies 
required  for  particles  to  penetrate  the  domes  and  accumulate  dose  in  the  silicon  detectors 
underneath  are  20,  35,  50  and  75  MeV  for  protons  and  1,  2.5,  5  and  10  MeV  for 
electrons.  Dose  from  particles  depositing  0.05-1  MeV  and  1-10  MeV  is  accumulated  in 
two  different  channels  called  EOEET  and  HIEET,  respectively.  HILET  dose  accumulates 
primarily  from  protons  with  energies  of  20-100  MeV,  but  electrons  with  energies  >  5 


Model  Name: 
Version: 
Developer: 
References: 
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MeV  may  contribute  during  large  eleetron  enhaneement  periods.  LOLET  dose 
accumulates  from  eleetrons,  bremsstrahlung,  and  protons  with  energies  >100  MeV.” 

The  CRRESRAD  science  module  is  used  to  map  the  radiation  dose  rate  data  sets  from  the 
CRRES  mission  onto  a  three-dimensional  grid  specified  by  the  user.  A  variety  of  magnetic  field 
models  can  be  used  for  the  mapping.  Thirty-six  data  sets  were  derived  from  the  CRRES  data  as 
described  by  the  following  excerpt  from  the  CRRESRAD  documentation: 

“The  dose  models  used  by  CRRESRAD  are  based  on  in  situ  dose  rate  measurements 
made  by  CRRES.  The  instrument  used  to  measure  dose  is  the  CRRES  Space  Radiation 
Dosimeter.  [...]  The  dosimeter  measured  aceumulated  dose  once  every  4.096  seeonds 
throughout  the  CRRES  mission.  The  measured  dose  rates  for  eaeh  dome  were  binned  by 
E  shell  and  B/BO  to  make  average  dose  rate  models  in  rads  (Si)  per  seeond.  The  width  of 
eaeh  bin  in  E  shell  is  1/20  Re,  and  the  width  of  eaeh  bin  in  B/BO  is  ~2  degrees  latitude  in 
a  dipole  field.  The  bins  form  a  two  dimensional  array  of  140  (E  Shell)  by  20  (B/BO)  and 
eover  E  shells  from  1  to  8  Re  and  magnetic  latitudes  of  0  degrees  to  -40  degrees.  The 
CRRES  mission  is  divided  into  two  parts.  The  magnetosphere  is  assumed  to  be  in  a  quiet 
configuration  before  the  Mareh  1991  storm  and  in  an  active  eonfiguration  after  the  Mareh 
storm.  A  model  was  made  separately  for  EOEET,  HIEET  and  EOEET+HIEET  for  each 
of  the  four  domes.  Three  sets  of  these  models  were  made:  one  for  quiet  eonditions  before 
the  storm  (27  July  1990  to  19  Mareh  1991),  one  for  active  conditions  after  the  storm  (31 
March  1991  to  12  October  1991)  and  one  for  average  conditions  over  the  entire  mission 
(27  July  1991  to  12  Oetober  1991).  These  combinations  result  in  36  different  dose  rate 
models.” 

After  the  user  selects  which  dataset  is  desired,  the  CRRESRAD  science  module  calculates  the 
B/L  coordinates  of  each  grid  point  from  the  user-speeified  magnetic  field  model.  The  resulting 
dose  rate  is  then  obtained  from  the  B/L  coordinates  and  the  ehosen  data  file.  In  this  manner,  a 
fully  three-dimensional  map  of  the  dose  rate  data  may  be  made  from  the  CRRES  data. 

Note:  Although  AE-GEOSpace  allows  the  data  to  be  mapped  in  three-dimensions  using 
a  variety  of  magnetic  field  models,  the  original  CRRES  data  was  binned  into  B/L 
coordinates  using  the  IGRF85  magnetie  field  with  an  Olson  and  Pfitzer  (1977) 
external  field.  The  user  should  be  aware  that  using  other  magnetic  field  models  to 
map  the  data  to  three-dimensional  space  is  inconsistent  with  the  original  reduction 
of  the  data. 

CRRESRAD  Inputs 

The  CRRESRAD  science  module  requires  the  user  to  specify  the  information  to  determine  which 
data  set  to  use  and  whieh  magnetic  field  model  to  use  in  mapping  the  data, 

B-Model:  The  magnetic  field  model  used  to  convert  from  the  B-L  coordinates  of  the 

model  to  three-dimensional  spaee.  While  the  model  used  to  reduce  the 
CRRES  data  was  IGRF85/0-P,  the  default  setting  uses  IGRF/O-P.  The  B- 
Model  options  include: 

Dipole:  A  dipole  field 

Dipole-Tilt:  A  tilted  dipole  field 
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Shielding; 


Channel: 


Aetivity: 


Dip-Tilt-Off: 

A  tilted-offset  dipole  field 

IGRF: 

The  International  Geomagnetie  Referenee  Field  with  no 
external  eontributions  (Extrapolation  beyond  2010). 

IGRF/O-P: 

The  IGRF  internal  field  with  the  Olson  and  Pfitzer 
(1977)  statie  model  to  represent  the  external  field. 

1GRF85; 

The  International  Geomagnetie  Referenee  Field  (1985) 
with  no  external  eontributions. 

1GRF85/0-P: 

The  IGRF85  internal  field  with  the  Olson  and  Pfitzer 
(1977)  statie  model  to  represent  the  external  field.  The 
original  CURES  data  was  redueed  using  this  option. 

The  shielding  parameter  speeifies  whether  the  82.5,  232.5,  457.5  or  886.5 
mil  aluminum  hemisphere  shielding  thiekness  data  set  is  to  be  used. 


The  ehannel  parameter  speeifies  whieh  dose  rate  data  set  is  to  be  used: 

LoLet.-  (0.05-1  MeV  deposited  from  eleetrons,  bremsstrahlung, 

and  >100  MeV  protons) 

Hi/Lo  Let:  (0.05-10  MeV  deposited)  =  LoLet  +  HiLet 

HiLet:  (1-10  MeV  deposited  from  20  -  100  MeV  protons  and 

>  5  MeV  eleetrons  during  large  enhaneement  periods) 

The  aetivity  parameter  speeifies  whether  the  Quiet  (obtained  before  the  24 
Mareh  1991  storm),  Active  (obtained  after  the  24  Mareh  1991  storm),  or 
Average  (average  of  the  Active  and  Quiet  intervals)  dose  rate  data  sets  are 
to  be  used. 


CRRESRAD  Outputs 

The  CRRESRAD  seienee  module  returns  a  3D  Gridded  Data  Set  of  the  dose  rate  in  units  of  rads 
(Si)  per  seeond  for  the  seleeted  shielding  level  and  deteetor  eombination. 
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The  CUTOFF  Science  Module 


Model  Name: 
Version: 
Developer: 
Referenees: 


Geomagnetic  Vertical  Cutoff  Rigidity  Interpolation  Model 
30  September  2005  (Version  4.03) 

D.F.  Smart  and  M.A.  Shea,  Air  Force  Research  Laboratory 

Fliickiger,  E.O.,  and  Kobel,  E.,  Aspects  of  Combining  Models  of  the 
Earth's  Internal  and  External  Magnetic  Eield,  J.  Geomag.  Geoelectr.,  42, 
1123 (1990) 

Kahler,  S.,  and  A.  Eing,  Comparisons  of  High  Eatitude  E  >  20  MeV 
Proton  Geomagnetic  Cutoff  Observations  with  Predictions  of  the  SEPTR 
yio&Ql,  Annales  Geophysicae,  20,  997-1005  (2002) 

Sabaka,  T.J.,  Eangel,  R.E.,  Baldwin,  J.A.,  and  Conrad,  J.A.,  The 
Geomagnetic  Eield  1900-1995,  Including  the  Earge-Scale  Eield  from 
Magnetospheric  Sources,  and  the  NASA  Candidate  Models  for  the  1995 
Revision  of  the  IGRE,  J.  Geomag.  Geoelect.,  49,  157  (1997) 

Shea,  M.A.,  Smart,  D.E.,  and  McCracken,  K.G.,  A  Study  of  vertical 
Cutoff  Rigidities  Using  Sixth  degree  simulations  of  the  Geomagnetic 
Eield,  J.  Geophys.  Res.,  70,  4117-4130  (1965) 

Shea,  M.A.,  and  Eliickiger,  E.O.,  Magnetospheric  Models  and  Trajectory 
Calculations,  Space  Science  Reviews,  93,  305-333  (2000) 

Smart,  D.E.,  and  Shea,  M.A.,  Geomagnetic  Cutoffs:  a  Review  for  Space 
Dosimetry  Applications,  HJv.  Space  Res.,  14(10),  787-796  (1994) 

Smart,  D.E.,  and  Shea,  M.A.,  World  Grid  of  Cosmic  Ray  Vertical  Cutoff 
Rigidities  for  Epoch  1990.0,  Proc.  Int.  Cosmic  Ray  Conf.  25‘^,  2,  401-404 
(1997a) 

Smart,  D.E.,  and  Shea,  M.A.,  Calculated  Cosmic  Ray  Cutoff  Rigidities  at 
450  km  for  Epoch  1990.0,  Proc.  Int.  Cosmic  Ray  Conf.  25‘^,  2,  397-400 
(1997b) 

Smart,  D.E,  Shea,  M.A.,  and  Eliickiger,  E.O.,  Calculated  Vertical  Cutoff 
Rigidities  for  the  International  Space  Station  during  Magnetically  Quiet 
Times,  Proc.  Int.  Cosmic  Ray  Conf.  26‘^,  7,  394-397  (1999a) 

Smart,  D.E.,  Shea,  M.A.,  Eliickiger,  E.O.,  Tylka,  A.J.,  and  Boberg,  P.R., 
Calculated  Vertical  Cutoff  Rigidities  for  the  International  Space  Station 
during  Magnetically  Active  Times,  Proc.  Int.  Cosmic  Ray  Conf.  26‘^,  7, 
398-401  (1999b) 

Smart,  D.E.,  Shea,  M.A.,  Eliickiger,  E.O.,  Tylka,  A.J.,  and  Boberg,  P.R., 
Changes  in  Calculated  Vertical  Cutoff  Rigidities  at  the  Altitude  of  the 
International  Space  Station  as  a  Eunction  of  Magnetically  Activity,  Proc. 
Int.  Cosmic  Ray  Conf.  26th,  7,  337-340  (1999c) 
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Smart,  D.F.,  and  Shea,  M.A.,  A  Comparison  of  the  Tsyganenko  Model 
Predieted  and  Measured  Geomagnetie  Cutoff  Latitudes,  Adv.  Space  Res., 
28(12),  1733-1738  (2001) 

Smart,  D.F.,  and  Shea,  M.A.,  The  Spaee-Developed  Dynamic  Vertical 
Cutoff  Rigidity  Model  and  Its  Applicability  to  Aircraft  Radiation  Dose, 
Adv.  Space  Res.,  32(1),  103-108  (2003) 

Smart,  D.F.,  M.A.  Shea,  AJ.  Tylka,  and  P.R.  Boberg,  A  Geomagnetic 
Cutoff  Rigidity  Interpolation  Tool:  Accuracy  Verification  and  Application 
to  Space  Weather,  AJv.  Space  Res.,  37,  1206-1217  (2006) 

Tsyganenko,  N.A.,  A  Magnetospheric  Field  Model  with  a  Warped  Tail 
Current  Sheet,  Planetary  Space  ScL,  37,  5-20  (1989) 

Note:  It  is  recommended  that  AF-GEOSpace  users  read  and  understand  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

CUTOFF  Overview 

The  CUTOFF  science  module  accesses  the  Geomagnetic  Vertical  Cutoff  Rigidity  Interpolation 
Model  to  generate  cutoff  rigidity  values  for  any  altitude  from  in  the  earth’s  atmosphere  (>  20 
km)  to  beyond  geosynchronous  orbit.  The  magnetic  rigidity  of  a  particle  is  a  measure  of  its 
resistance  to  a  magnetic  field  that  deflects  it  from  a  straight-line  trajectory.  Specifically,  rigidity 
R  =  pc/q  where  p  is  the  particle  momentum,  c  is  the  speed  of  light,  and  q  is  the  particle  charge. 
Generally,  particles  with  higher  rigidities  are  more  likely  to  gain  access  to  a  given  location  inside 
the  magnetosphere.  Typically,  at  a  given  location  there  is  an  upper  cutoff  rigidity  value  (above 
which  all  rigidities  are  allowed,  and  a  lower  cutoff  rigidity  value  (below  which  all  rigidities  are 
forbidden).  Between  the  upper  cutoff  and  the  lower  cutoff  there  is  an  alternating  series  of 
allowed  and  forbidden  trajectories  called  the  cosmic  ray  penumbra  which  is  both  rigidity  and 
magnetic  activity  dependent.  Owing  to  penumbral  transparency,  an  "effective  cutoff  rigidity" 
value  is  also  determined.  Geomagnetic  cutoffs  also  depend  on  particle  direction  with  the 
maximum  geomagnetic  cutoff  in  the  magnetic  east  direction  (90°  from  the  zenith)  and  the 
minimum  geomagnetic  cutoff  in  the  magnetic  west  direction  (90°  from  the  zenith).  The 
geomagnetic  cutoffs  in  the  north  and  south  magnetic  planes  are  approximately  equal  to  the  cutoff 
in  the  vertical  (zenith)  direction.  For  convenience,  the  geomagnetic  cutoff  values  are  provided 
both  in  terms  of  rigidity  [in  GV]  and  proton  energy  [in  MeV].  Modeled  and  measured  cutoffs  at 
620  km  exhibit  the  same  general  trend,  however,  measured  cutoffs  were  about  one  degree  in 
latitude  equatorward  of  those  modeled  during  magnetically  active  times  [Smart  and  Shea,  2001]. 
Extending  down  into  the  atmosphere,  cutoff  rigidity  model  output  used  for  computing  aircraft 
radiation  dose  resulted  in  good  agreement  during  the  high-energy  solar  cosmic  ray  event  of  24 
October  1982  [Smart  and  Shea,  2003].  The  following  is  a  summary  of  the  procedure  used  to 
determine  the  cutoff  rigidity  model  quantities  within  AE-GEOSpace. 

Background:  Smart  et  al.  [1999c]  performed  basic  geomagnetic  vertical  cutoff  rigidity 
calculations  using  proton  trajectory- tracings  initiated  from  450  km  altitude  on  a  5°  x  5°  world 
grid  for  specified  levels  of  magnetic  activity  quantified  by  integer  Kp  value  and  quantized 
Universal  time  (0000,  0600,  1200,  and  1800  hours  UT).  Please  note  that  the  previous  release, 
AE-GEOSpace  V2.1,  contained  CUTOEE  Version  4.01  of  3  June  2003. 
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For  this  version  of  the  model,  these  calculations  were  performed  using  quantized  Universal  time 
every  three  hours  (0000,  0300,  0600,  0900,  1200,  1500,  1800,  and  2100  hours  UT)  [see  Smart  et 
al,  2006].  Orbits  of  particles  with  specific  rigidity  values  were  traced  backwards  to  determine  if 
access  from  space  was  allowed  or  forbidden  at  each  location.  Penumbral  transparency,  a  value 
from  between  0  and  1 ,  is  the  fraction  of  allowed  rigidities  as  determined  by  going  through  the 
penumbra  in  steps  of  0.01  GV.  The  effective  cutoff  rigidity  within  the  penumbra  is  then 
determined  by  subtracting  the  transparent  fraction  of  the  penumbra  from  the  upper  cutoff  rigidity 
value  [Shea  et  al,  1965].  The  magnetospheric  magnetic  field  was  defined  for  1  January  1995  and 
used  the  IGRF  1995  internal  field  [Sabaka  et  al,  1997]  and  the  Tsyganenko  [1989] 
magnetospheric  model  as  combined  by  Fluckiger  and  Kobel  [1990].  Because  the  Tsyganenko 
[1989]  model  only  describes  magnetospheric  configurations  for  Kp  indices  of  0  to  5,  the  Boberg 
[1995]  extension  was  used  in  increments  of  -100  nT  to  include  Dst  effects  to  represent  probable 
conditions  for  Kp  6  through  9  and  "10".  For  example,  the  Kp  =  7  configuration  is  represented  by 
the  Tsyganenko  [1989]  Kp  =  5  model  plus  a  -200  nT  ring  current  extension.  See  Smart  et  al, 
[1999a,  1999b,  1999c,  2000,  2006]  for  more  details  on  the  geomagnetic  cutoff  rigidity 
determinations  and  the  trajectory  tracing  processes.  The  results  of  these  calculations  are  archived 
within  AF-GEOSpace  for  use  in  the  general  interpolation  procedure  described  below. 

Interpolation  Method:  The  Mcllwain  "L"  parameter  can  be  utilized  in  the  cutoff  equation  for 
the  cosine  squared  of  the  magnetic  latitude  such  that  the  vertical  cutoff  rigidity  equation  used  has 
the  form: 

R  =  V(k)/  l} 

with  V(k)  being  a  constant  in  the  cutoff  rigidity  equation  that  varies  with  grid  location,  i.e., 
latitude  and  longitude  (see  Smart  and  Shea  [1994]).  First,  a  linear  interpolation  uses  the  V(k) 
values  and  associated  L  values  at  450  km  from  the  nearest  4  points  in  the  5°  x  5°  world  grid  to 
determine  the  cutoff  rigidity  R  at  the  satellites  latitude,  longitude  and  an  altitude  of  450  km. 
Multiplying  the  interpolated  R  value  by  (using  the  L  appropriate  for  the  satellite's  latitude, 
longitude,  and  a  450  km  altitude)  produces  the  V(k)  constant  appropriate  for  the  satellite 
location.  This  V(k)  is  then  combined  with  the  satellite's  actual  L  value  in  the  above  equation  to 
produce  an  extrapolated  vertical  geomagnetic  cutoff  rigidity  for  the  satellite's  position.  After  the 
vertical  cutoff  rigidity  is  determined,  Stormer  theory  is  used  to  translate  to  cutoff  values  at  90 
degrees  east  and  90  degrees  west.  The  Stormer  equation  (valid  in  a  magnetic  dipole 
configuration)  can  be  written  in  the  form: 

Ra  =  4R  {[  1  +  (1  -  sine  sincp  cos^k)^"]^  } 

In  this  equation  Rq  is  the  cutoff  rigidity  in  a  specific  angular  direction,  R  is  the  vertical  cutoff 
rigidity,  X  is  an  appropriate  magnetic  latitude,  s  is  the  angle  from  the  zenith  direction,  and  (p  is 
the  azimuth  angle  measured  clockwise  from  magnetic  north.  Owing  to  discrepancies  arising 
between  invariant  and  magnetic  latitude  at  high  altitudes,  the  corrected  geomagnetic  latitude  is 
also  calculated  and  used  above  for  X  if  it  is  smaller  than  the  invariant  latitude  A  =  acos(L''^").  As 
noted  above,  the  angular  geomagnetic  cutoffs  are  lowest  from  the  magnetic  west  and  highest 
from  the  magnetic  east  while  the  cutoffs  in  the  magnetic  north  and  south  directions  are  the  same 
as  the  vertical  cutoff. 
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CUTOFF  Inputs 

The  CUTOFF  science  module  requires  the  Global  Parameters  Year,  Day,  UT,  and  Kp  (SSN, 
F10.7  and  Ap  are  not  used).  The  Kp  index  has  28  defined  values,  i.e.,  {0,  0^,  F,  1,  1^,  2',  2,  2^,  3 
,  3,  3^,  4',  4,  4^,  5',  5,  5^,  6',  6,  6^,  T,  7, 1^,  8',  8,  8"^,  9',  9}.  The  decimal  equivalents  from  the 
Global  data  set  represent  a  Kp  index  of  0  with  0.0,  0"^  with  0.3,  Fwith  0.7,  1  with  1.0,  I’^with 
1.3,  2' with  1.7,  2  with  2.0,  2^  with  2.3,  etc.  Note  that  there  is  no  Kp  =  O'  or  9^.  The  CUTOFF 
module  utilizes  10  Kp-dependent  coefficient  sets  with  a  different  set  for  each  Kp  integer-based 
grouping  such  as  Kp  =  {2-,  2,  or  2+}.  For  manual  entry  in  the  AF-GEOSpace  Global  text  field, 
the  same  Kp  =  “2”  coefficient  set,  for  example,  can  be  accessed  if  the  decimal  index  is  in  the 
range  1.60  <  Kp  <  2.60.  Note  that  while  the  model  authors  provide  sets  of  coefficients  to 
represent  the  extreme  Kp  =  9  and  “Kp=10”  conditions,  these  sets  are  not  presently  accessible 
with  AF-GEOSpace  owing  to  fixed  input  restrictions  on  the  input  Global  Kp.  Note  that  the 
model  determines  output  by  interpolating  tabulated  rigidity  and  proton  cutoff  values  stored  at 
spatial  intervals  of  5  degrees  in  latitude  by  5  degree  in  longitude.  The  default  Grid  Tool  uses  37 
latitude  and  73  longitude  grid  points  to  match  this  resolution.  Note:  20  km  is  the  lowest  radial 
input,  i.e.,  the  top  of  the  atmosphere,  so  any  lower  number  will  be  assigned  the  20  km  result. 

CUTOFF  Outputs 

The  CUTOFF  science  module  returns  a  3D  Gridded  Data  Set  of  the  following  quantities: 

E  Mcllwain  E  coordinate  (Earth  radii) 

InvEt  Invariant  or  corrected  geomagnetic  latitude  (degrees) 

PTV  Penumbral  transparency  at  this  cutoff  rigidity 

REGVPV  Eower  cutoff  rigidity  (GV)  in  the  vertical  direction. 

RUGVPV  Upper  cutoff  rigidity  (GV)  in  the  vertical  direction. 

RCGVPV  Effective  cutoff  rigidity  (GV)  in  the  vertical  direction. 

REGVPE  Eower  cutoff  rigidity  (GV)  in  the  90°  East  direction. 

RUGVPE  Upper  cutoff  rigidity  (GV)  in  the  90°  East  direction. 

RCGVPE  Effective  cutoff  rigidity  (GV)  in  the  90°  East  direction. 

REGVPW  Eower  cutoff  rigidity  (GV)  in  the  90°  West  direction. 

RUGVPW  Upper  cutoff  rigidity  (GV)  in  the  90°  West  direction. 

RCGVPW  Effective  cutoff  rigidity  (GV)  in  the  90°  West  direction. 

EPNRLV  Eower  proton  cutoff  (MeV)  in  the  vertical  direction. 

EPNRUV  Upper  proton  cutoff  (MeV)  in  the  vertical  direction. 

EPNRCV  Effective  proton  cutoff  (MeV)  in  the  vertical  direction. 

EPNRLE  Eower  proton  cutoff  (MeV)  in  the  90°  East  direction. 

EPNRUE  Upper  proton  cutoff  (MeV)  in  the  90°  East  direction. 

EPNRCE  Effective  proton  cutoff  (MeV)  in  the  90°  East  direction. 

EPNRLW  Eower  proton  cutoff  (MeV)  in  the  90°  West  direction. 

EPNRUW  Upper  proton  cutoff  (MeV)  in  the  90°  West  direction. 

EPNRCW  Effective  proton  cutoff  (MeV)  in  the  90°  West  direction. 

We  recommend  displaying  output  in  2D  or  3D  plots  using  the  COORD-SLICE  graphical  object 
or  examining  output  along  an  orbit  by  running  the  SATEL-APP  application  followed  by  the 
ORBIT-PROBE  graphical  object. 
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The  GCPM  Science  Module 


Global  Core  Plasma  Model 

Version  2.4  of  19  June  2009  based  on  Gallagher  et  al.  [2000] 

D.L.  Gallagher,  NASA  Marshall  Space  Flight  Center,  Huntsville,  AL 
(Code  source-  http://plasmasphere.nasa.gov/models/) 

D.  Bilitza  and  Reinisch,  B.,  International  Reference  Ionosphere  2007: 
Improvements  and  new  parameters,  J.  Adv.  Space  Res.,  42,  #4,  599-609, 
doi:I0.I0I6/j.asr.2007.07.048  (2008) 

Gallagher,  D.,  P.  Craven,  and  R.  Comfort,  Global  core  plasma  model,  J. 
Geophys.  Res.,  105(A8),  18819-18833  (2000). 

Note:  It  is  recommended  that  AF-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

GCPM  Overview 

The  Global  Core  Plasma  Model  (GCPM)  of  Gallagher  et  al.  [2000]  is  an  empirical  description  of 
thermal  plasma  densities  (e-,  H^,  He^,  and  O^)  in  the  plasmasphere,  plasmapause, 
magnetospheric  trough,  and  polar  cap.  The  authors  note  that  GCPM  is  intended  to  provide 
representative  thermal  plasma  densities  in  these  regions,  but  is  not  intended  to  represent  the 
distribution  of  thermal  plasma  density  at  any  given  time.  GCPM-2008  uses  the  Kp  index  and  is 
coupled  to  the  International  Reference  Ionosphere  [Bilitza  and  Reinisch,  2008]  in  the  transition 
region  500-600  km  (see  IRI2007  Science  Module  section  for  details)  which  requires  additional 
input  quantities  provided  in  data  fdes. 

GCPM  Inputs 

Note:  Valid  run  times  are  limited  by  the  content  of  file  ig_rz.dat  described  below. 

Global  Parameters:  Year,  Day,  UT,  and  Kp 
(SSN  is  not  required) 

FIO.  7  and  Ap  are  required  for  IRI2007,  but  the  values  entered  in  the 
Globals  section  are  ignored.  FIO.  7  and  Ap  are  read  directly  from  file 
$AFGS_HOME/models/data/IRI2007/ap.dat.  File  updates  are  made 
available  periodically  via  FTP  (http://iri.gsfc.nasa.gov/). 

Required  Data  files:  IRI2007  retrieves  all  input  quantities  (except  for  the  time)  from  data  files 

found  in  folder  $AFGS_HOME/models/data/IRI2007,  namely 

dgrf##.dat,  igrf05.dat,  igrf05s.dat:  Definitive  IGRF  and  IGRF  coefficients 
for  the  years  1945-2010  (##  =  two-digit  year) 

URSI##.asc:  Coefficient  files  for  the  URSI  model  (##  =  month  +10) 
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ig_rz.dat:  File  contains  (1)  the  ionospheric  index  (IG12)  based  on 

foF2  measurements  from  a  dozen  ionosondes  correlated 
with  CCIR  foF2  maps  \Liu  et  al,  1983]  and  (2)  the  12- 
month  running  mean  of  sunspot  number  (Rzl2)  for 
1958  thru  2012.  If  a  date  outside  this  range  is  used,  no 
valid  output  can  be  generated  owing  to  lack  of  inputs 
for  the  IRI2007  model.  File  updates  are  made  available 
periodically  via  FTP  at  http://iri.gsfc.nasa.gov/. 

ap.dat:  Contains  3 -houx  Ap  magnetic  index  and  FI 0.7  daily 

index  from  1958  thru  30  April  2010.  If  a  date  outside 
this  range  is  used,  then  the  y4j!7-dependent  “foF2  storm 
model”  [FuUer-Rowell  et  al,  2000;  Araujo-Pradere  et 
al,  2002]  will  be  turned  off  within  the  IRI2007  model. 
File  updates  available  periodically  via  FTP  at 
http://iri.gsfc.nasa.gov/. 


GCPM  Outputs 

The  GCPM  Science  Module  returns  3D  Gridded  data  sets  of  total  density  (#/cm  )  of  electrons, 
hydrogen  (H"^),  helium  (He"^),  and  oxygen  (O^).  Best  viewed  by  checking  the  Log  10  box  within 
of  the  Data  Map  Graphical  Option. 
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The  lONSCINT  Science  Module  (V2.5.1  Only) 


Model  Name: 

Version: 

Developer: 

Sponsor: 

Referenees: 


High  Fidelity  lonospherie  Seintillation  Simulation  Algorithm 
(lONSCINT) 

2.00(13Maroh  2000) 

Radex,  Ine.  (now  AER,  Ine.)  and  the  Air  Foree  Researeh  Laboratory 

Air  and  Space  Natural  Environment,  Modeling  and  Simulation  Executive 
Agent  (ASNE  MSEA),  Ashville,  NC 

Secan,  J.A.,  and  R.M.  Bussey,  An  Improved  Model  of  High-Latitude  F- 
Region  Scintillation  (WBMOD  Version  13),  PL-TR-94-2254  (1994),  ADA 
288558 


Note:  It  is  recommended  that  AF-GEOSpace  users  read  and  understand  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 


lONSCINT  Overview 

The  High  Fidelity  Ionospheric  Scintillation  Simulation  Algorithm  (lONSCINT)  provides 
realistic  scenarios  of  disruptions  in  trans-ionospheric  radio  wave  communications  with  spacecraft 
due  to  equatorial  scintillation.  The  resulting  signal  fades  encountered  by  ground-to-satellite  links 
are  due  to  instabilities  in  the  ionospheric  F-region  related  to  spread-F  plumes  that  develop  after 
sunset  when  conditions  are  favorable.  This  module  addresses  only  satellites  positioned  in 
geosynchronous  orbit  and  is  limited  to  a  frequency  of  244  MHz.  While  scintillation  can  occur  in 
both  amplitude  and  phase,  lONSCINT  treats  only  the  intensity  (or  amplitude)  scintillation. 

This  excerpt  from  the  user’s  manual^  contains  more  background  and  description: 

“Prior  to  the  development  of  lONSCINT,  the  only  tools  available  for  the  prediction  of 
scintillation  for  simulation  purposes  were  statistical  (climatological)  models,  most 
notably  the  Wide  Band  model  (WBMOD).  Although  expressing  the  seasonal,  daily  and 
solar  cycle  variability  of  equatorial  scintillations  on  average,  these  models  did  not  allow 
for  the  introduction  of  day-to-day  variability  in  scintillation,  even  in  an  average  sense. 

Since  equatorial  scintillations  are  in  fact  extremely  variable  from  day-to-day  at  a  given 
location,  simulation  results  based  only  on  the  average  scintillation  levels  were  necessarily 
lacking  in  a  critical  feature  of  the  spread-F  phenomenon  itself.  The  lONSCINT  program 
was  developed  to  overcome  the  limitations  of  climatological  models  for  simulations  by 
reproducing  both  the  climatological  and  the  day-to-day  variability  of  equatorial 
scintillations,  thereby  producing  a  simulation  result  [that]  is  much  more  in  line  with 
actual  expected  conditions  for  any  particular  simulation  scenario. 

lONSCINT  generates  simulated  scintillation  results  by  “replaying”  measured  scintillation 
scenarios  for  a  specified  season  and  set  of  geophysical  conditions,  drawing  on  nightly 
data  measured  over  [the  four  years  prior  to  2000]  in  the  South  America  sector.  These 


^  User’s  Guide  for  the  High  Fidelity  Ionospheric  Scintillation  Simulation  Algorithm,  Prepared 
for  AFRLWSB  by  Radex,  Inc.,  March  8  (2000) 
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nightly  measured  seenarios  are  used  to  drive  a  model  for  spread-F  plume  development 
and  evolution  that  was  developed  as  part  of  the  Scintillation  Network  Decision  Aid 
(SCINDA)  model,  from  extensive  experience  with  scintillation  data.  The  scenarios  are 
selected  pseudo-randomly  to  conform  to  the  correct  average  seasonal  behavior  yet 
preserve  the  day-to-day  variability.  The  South  America  data  set  is  extrapolated  to 
arbitrary  positions  on  the  Earth  through  the  use  of  average  climatology  predictions 
(WBMOD).  The  basic  result  is  a  simulated  prediction  of  scintillation  intensity 
throughout  a  specified  time  of  day  and  year  and  under  specified  geophysical  conditions. 

The  result  is  suitable  for  the  production  of  geographic  maps  of  satellite  outages”. 

lONSCINT  Inputs 

The  lONSCINT  science  module  requires  the  following  inputs, 

Global  Parameters:  Year,  Day,  UT,  Kp,  and  SSN  (F10.7  and  Ap  are  not  used). 

Random  Number  Seed:  A  negative  integer  (magnitude  <  30,000)  used  to  select  from  among  5 1 

scintillation  scenarios  available  to  the  model.  Using  the  same  input  seed 
will  cause  the  same  sequence  of  scintillation  scenarios  to  be  generated.  To 
recreate  the  same  scenario  for  more  than  one  satellite,  perform  additional 
separate  lONSCINT  runs  using  the  same  Random  Number  Seed  for  each 
satellite  (as  defined  by  its  Satellite  Longitude,  see  below). 

Theater:  The  following  geographic  latitude  and  longitude  values  define  the  theater 

over  which  scintillation  conditions  will  be  computed.  Theater  width  is 
limited  to  a  maximum  of  90°. 


Eat  1: 

Southern  boundary  of  the  theater  in  geocentric  latitude 
in  degrees. 

Eat  2: 

Northern  boundary  of  the  theater  in  geocentric  latitude 
in  degrees. 

Lon  1: 

Western  boundary  of  the  theater  in  geocentric  East 
longitude  in  degrees. 

Lon  2: 

Eastern  boundary  of  the  theater  in  geocentric  East 
longitude  in  degrees. 

Note:  The  Grid  Tool  is  not  active  for  the  lONSCINT  science  module.  The  calculation  is 
performed  using  a  fixed  resolution  geographical  grid  (1°  x  1°)  defined  by  the  integer 
values  of  the  Theater  latitude  and  longitude  boundaries  given  above.  The  scintillation 
climatology  produced  in  the  simulation  is  representative  of  the  seasonal  behavior  at 
the  mid-point  of  the  chosen  theater. 

Satellite  Longitude:  Geographic  longitude  (degrees  East)  of  the  geosynchronous  satellite 
(geographic  latitude  is  internally  fixed  equal  to  zero  degrees). 

Sunspot  Number  and  KP:  The  sunspot  number  and  geomagnetic  activity  level  may  be  provided 
to  lONSCINT  in  the  following  two  ways, 

Globals:  lONSCINT  will  obtain  SSN  and  Kp  from  the  global 

parameter  values  available  to  AF-GEOSpace.  For  static 
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runs,  these  parameters  appear  in  the  text  boxes  at  the 
top  of  the  environment  window.  For  dynamic  runs,  the 
SSN  and  Kp  values  to  be  used  are  listed  in  the 
dynamics  global  parameter  list  viewable  by  accessing 
the  Globals  menu  and  selecting  the  Show  option.  Both 
sources  can  be  edited  directly  by  the  user. 

Constant:  lONSCINT  will  use  constant  SSN  and  Kp  values  that 

the  user  provides  by  editing  the  following  two  text 
boxes  directly  in  the  lONSCINT  Options  window. 

SSN:  Sunspot  number  (see  note  below) 

Kp:  Geomagnetic  activity  index  (values  0.00  to  9.00) 

Note:  The  SSN  values  provided  by  AF-GEOSpace  are  identical  to  the  daily  values  archived 
by  NGDC.  The  lONSCINT  authors  note  that  the  daily  sunspot  number  is  not  well 
correlated  with  scintillation  and  that  the  preferred  sunspot  number  to  use  should 
represent  the  smoothed  ~90-day  average  of  the  daily  values,  e.g.,  it  will  suffice  to 
choose  a  value  representative  of  the  position  in  the  solar  cycle.  The  authors  suggest, 
for  example,  using  SSN  =  10  to  represent  solar  minimum,  SSN  =  50  to  represent  the 
ramp  up  or  down  from  solar  maximum,  and  SSN  =100  and  150  to  represent  “low- 
activity”  and  “high-activity”  solar  maximum  values,  respectively. 

Operational  Mode:  lONSCINT  output  can  be  calculated  using  two  different  methods. 

Plume:  lONSCINT  produces  scintillation  output  based  on  day- 

to-day  measurements  such  that  scintillation  at  a  given 
time  of  day  and  location  differs  substantially  from  day 
to  day.  This  mode  incorporates  realistic  statistical 
“random”  variations  in  the  scintillation. 

Climo:  lONSCINT  produces  scintillation  output  made  with  the 

average  scintillation  model  WBMOD.  For  details,  see 
the  WBMOD  Science  Module  section  of  this  document. 

For  both  the  Plume  and  Climo  methods,  two  parameters  must  be  specified. 

Scintillation  Intensity:  This  specifies  the  desired  scintillation  intensity 
(0.00  to  1.00).  The  scintillation  intensity  should 
typically  be  set  to  -0.5  when  in  the  Plume  mode.  For 
Climo  mode  (when  WBMOD  results  are  utilized)  a 
value  of  0.5  tends  to  give  rather  weak  results  so  it  is 
suggested  that  a  value  -0.90  be  used.  This  will  result  in 
the  evaluation  of  the  WBMOD  climatology  at  the  90* 
percentile  level  as  is  quite  commonly  done  for 
prediction  purposes. 

Percentile  for  S4  to  dB  fade:  This  specifies  the  percentile  (0  to  100)  used 
to  produce  the  dB  fade  corresponding  to  each  S4  value 
produced  in  the  output,  e.g.,  if  0.95  is  specified,  then 
the  dB  fade  value  will  correspond  to  the  fade  level  of 
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the  top  5%  of  all  fades  eorresponding  to  eaeh  S4.  The 
parameter  is  also  known  as  the  Nakagami  pereentile. 


lONSCINT  Outputs 

The  lONSCINT  seienee  module  returns  2D  Gridded  Data  Sets  representing  the  seintillation 
parameters  on  a  1°  x  1°  geographie  eoordinate  grid.  We  reeommend  displaying  output  in  2D 
plots  using  the  COORD-SLICE  graphieal  objeet.  AF-GEOSpaee  will  then  display  a  spatial 
distribution  (map)  for  the  following  parameters: 


S4Index: 


dBfade: 


ProbCom: 


SatElev: 


The  S4  scintillation  index,  a  normalized  standard  deviation  of  the  signal 
intensity  (dimensionless).  It  is  common  to  refer  to  scintillation  threshold 
levels  of  0.3  and  0.6  as  “yellow”  and  “red”  to  indicate  interference  and 
outage,  respectively. 

The  dB  fade  depth  of  the  signal  intensity  (decibels).  It  is  directly  related  to 
the  S4Index  through  the  selection  of  the  Percentile  for  S4  to  dB  Fade  input 
parameter.  For  a  given  value  of  S4Index,  the  value  of  dBfade  increases  as 
the  value  of  Percentile  for  S4  to  dB  Fade  increases. 

The  probability  of  communication  breakdown  is  a  value  between  zero  and 
100%  indicating  the  probability  of  communications  problems.  This  is 
defined  as  zero  when  S4Index  is  below  0.3  (“yellow”  threshold)  and  as 
100%  when  S4Index  is  greater  than  0.6  (“red”  threshold).  Note  that  it  is 
therefore  possible  to  have  non-zero  S4Index  and  dBfade  values  with  no 
communications  problems  indicated. 

The  elevation  angle  (degrees)  of  the  satellite  as  measured  from  locations 
within  the  defined  theater,  i.e.,  equal  to  90  degrees  when  satellite  is 
directly  overhead. 
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The  lONSCINT-G  Science  Module 


GPS  Version  of  the  High  Fidelity  lonospherie  Scintillation  Simulation 
Algorithm  (lONSCINT-G) 

July  2009 

AER,  Inc.  and  the  Air  Force  Research  Laboratory 

Secan,  J.A.,  and  R.M.  Bussey,  An  Improved  Model  of  High-Latitude  F- 
Region  Scintillation  (WBMOD  Version  13),  PL-TR-94-2254  (1994),  ADA 
288558 

Steenburgh,  R.A.,  C.G.  Smithtro,  and  K.M.  Groves,  Ionospheric 
scintillation  effects  on  single  frequency  GPS,  Space  Weather,  6,  S04D02, 
doi:10.1029/2007SW000340  (2008) 

Note;  It  is  recommended  that  AF-GEOSpace  users  read  and  understand  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

lONSCINT-G  Overview 

The  lONSCINT-G  Science  Module  is  a  simulation  tool  for  producing  realistic  scenarios  of 
disruptions  in  trans-ionospheric  radio  communications  at  GPS  frequencies  between  spacecraft 
and  stationary  platforms.  It  is  based  on  the  model  “The  GPS  Version  of  the  High  Fidelity 
Ionospheric  Scintillation  Simulation  Algorithm  (lONSCINT-G).”  Given  a  time  interval,  a 
selection  of  scintillation  database  options  related  to  solar  activity  conditions,  a  random  number 
seed,  and  a  platform  position,  the  lONSCINT-G  Science  Module  can  produce  a  time  series  of 
skymaps  showing  S4  scintillation  as  a  function  of  azimuth  and  elevation  angle  as  measured  from 
the  platform  position.  The  scintillation  scenarios  are  selected  at  random  from  data  taken  from  a 
fixed  L-Band  link  over  various  years  (1997  -  2001).  The  following  background  information  is 
excerpted  from  the  lONSCINT-G  user’s  manual  . 

“Equatorial  scintillation  exhibits  pseudo-random  elements  in  that  it  is  composed  of 
discrete  “plumes”  which  stretch  along  magnetic  field  lines  rather  predictably,  but  vary  in 
longitudinal  extent  in  an  unpredictable  manner.  Scintillation,  especially  at  GPS 
frequencies,  can  best  be  thought  of  as  an  on-again,  off-again  process  when  viewed  from  a 
fixed  point  on  the  Earth,  with  a  time  scale  of  perhaps  an  hour.  The  occurrence  of 
scintillation  on  a  night-to-night  basis  is  also  difficult  to  predict.  Although  there  are  times 
of  the  year  for  various  longitude  sectors  during  which  scintillation  is  nearly  absent,  it  is 
typical  for  a  night  with  no  scintillation  in  a  particular  region  to  follow  a  night  of  strong 
scintillation.  This  makes  “average”  climatological  scintillation  models  (WBMOD) 
difficult  to  incorporate  into  realistic  simulations  of  scintillation  impact  on  receivers. 

The  lONSCINT-G  program  addresses  this  need  by  incorporating  the  random  nature  of 
scintillation  into  the  production  of  nightly  scintillation  scenarios,  which  are  constrained 
by  geomagnetic  latitude,  solar  cycle,  and  time  of  year.  The  scenarios  are  generated  by 
piecing  together  nightly  measurements  of  scintillation  from  a  fixed  ground-to-satellite 
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link  at  GPS  frequencies  to  form  a  global  picture  of  scintillation  which  contains  the 
discrete  “plumes”  which  are  characteristic  of  actual  nightly  scintillation,  as  opposed  to 
the  time-averaged  probabilities  which  would  be  obtained  from  climatological  modeling. 

The  lONSCINT-G  representation  of  scintillation  in  a  theater,  consisting  of  regions  of 
high  intensity  separated  by  regions  of  no  scintillation,  is  especially  important  for  GPS 
navigation  investigations  where  the  number  of  satellites  effected  and  their  positions  are 
the  critical  issue.  However,  this  improved  realism  comes  with  a  price  which.  For 
lONSCINT-G,  is  the  fact  that  a  single  run  cannot  be  used  to  assess  overall  impact. 

Rather,  a  run  of  the  software  represents  what  might  be  expected  on  a  single  day.  It  is 
entirely  possible,  for  example,  for  a  run  to  produce  no  significant  scintillation  for  a  given 
platform  and  night,  even  at  the  height  of  scintillation  season  and  at  solar  maximum. 
Therefore,  multiple  runs  for  the  system  with  subsequent  analysis  must  be  used  to  assess 
possible  impacts.  Worst  case  scenarios  are  built  into  lONSCINT-G  to  aid  in  this 
evaluation.” 

lONSCINT-G  Inputs 

The  lONSCINT-G  Science  Module  requires  four  types  of  inputs  used  to  define  (1)  a  static  run 
time  or  dynamic  run  time  interval,  (2)  scintillation  database  options  to  characterize  the  type  of 
scenario  desired  along  with  a  large  random  number  seed  (typically  a  5-digit  number),  (3)  the 
static  platform  position,  and  (4)  the  resolution  in  azimuth  and  elevation  of  the  S4  scintillation 
skymap  to  be  created  representing  the  view  from  the  user-specified  platform.  Specifically,  the 
following  inputs  are  required. 

Global  Parameters:  Year,  Day,  UT  (Kp,  SSN,  F10.7,  and  Ap  are  not  used). 

Scintillation  Database  Options:  Scenarios  are  generated  from  the  scintillation  database  using  an 
input  solar  activity  level  and  four  related  selection  modifiers,  namely 

Sunspot  Activity  Level:  Scintillation  scenarios  corresponding  to  four 

different  levels  of  solar  activity  as  defined  by  sunspot 
number  (SSN)  are  represented.  It  should  be  noted  that 
no  significant  scintillation  at  GPS  frequencies  occurs  at 
solar  minimum  and  “worst  case”  scenarios  are 
associated  with  maximum  SSN  values. 

1  =  Low  (10-30):  This  SSN  range  represents  solar 
minimum  conditions. 

2  =  Moderate  (50-75):  This  SSN  range  represents 
conditions  during  the  ramp  up  or  down  from  solar 
maximum. 

3  =  High  (85-100):  This  SSN  range  represents 
conditions  from  a  “low-activity”  maximum. 

4  =  Maximum  (1 00- 1 20):  This  SSN  range  represents 
conditions  from  a  “high-activity”  maximum. 

Use  Seasonal  Climatology:  This  option  provides  the  most  realistic 
representation  of  the  seasonal  dependence  of 
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scintillation  as  a  function  of  longitude.  If  the  occurrenee 
of  seintillation  is  desired  at  all  longitudes  regardless  of 
scintillation  season,  then  uncheck  this  option.  Note  that 
quiet  scintillation-free  nights  ean  still  occur  even  with 
this  option  unchecked. 

Use  Only  Top  10%  Scintillation  Scenarios:  Selecting  this  option 

highlights  the  “worst”  of  the  possible  scenarios,  i.e.,  it 
restricts  scenario  selection  to  be  made  randomly  from 
only  those  portions  of  the  database  representing  the  top 
10%  of  nights  based  on  the  total  time  of  active 
scintillation  per  night.  If  left  unchecked,  then  scenario 
sets  will  be  chosen  randomly  from  all  in-season  nights 
for  the  chosen  solar  activity  level. 

Retain  Generated  Random  Number  Seed  Between  Runs:  Each  time  a  new 
lONSCINT-G  entry  appears  in  the  Active  Modules  list, 
e.g.,  ScilonScintgO,  a  new  random  number  is  placed  in 
the  text  box  to  the  right  of  the  next  input  line.  Each  run 
utilizes  the  random  number  seed  that  is  visible  before 
the  run  is  made.  This  value  is  used  to  randomize  the 
selection  of  scenario  sets  from  the  appropriate  solar 
aetivity  level  section  of  the  database.  Eor  a  given  set  of 
activity  settings,  using  the  same  number  seed  will  cause 
the  same  scintillation  scenario  to  be  generated.  Select 
this  option  to  retain  use  of  the  random  number  seed  for 
additional  runs.  If  neither  this  nor  the  next  option  is 
checked,  then  a  Run/Update  will  place  a  new  random 
number  seed  in  the  text  box  (to  be  used  for  the  next 
run!).  If  you  complete  a  run  without  checking  this 
option  and  did  not  record  the  number  seed,  you  can 
recover  the  value  used  in  your  last  run  from  file 
C:\TEMP\SciIonScintgiMONSCINTG.OUT  (assuming 
default  scratch  directory  C:\TEMP). 

Specify  and  Retain  Random  Number  Seed:  Select  this  option  and  edit  the 
number  seed  value  in  the  text  box  to  retain  use  of  the 
number  seed  for  the  current  and  future  runs.  Using  the 
same  input  seed  will  cause  the  same  scintillation 
scenario  to  be  generated.  To  reereate  the  same  scenario 
for  more  than  one  Platform  Position,  perform  additional 
lONSCINT-G  Science  Module  runs  using  the  same 
Random  Number  Seed  for  each  platform  location. 

Platform  Position:  The  Platform  Position  defines  the  fixed  reference  position  used  for  all 

GPS  scintillation  scenario  calculations.  Note  that  there  will  be  no 
scintillation  directly  overhead  (i.e.,  at  the  center  of  the  skymap  viewed 
with  the  lONSCINT-G  graphie  module)  if  the  platform  is  placed  at  a 
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magnetic  latitude  poleward  of  30  degrees.  The  location  is  input  in 
geographic  coordinates  assuming  a  spherical  Earth,  namely 

Latitude:  The  platform’s  North  latitude  in  degrees. 

Longitude:  The  platform’s  East  longitude  in  degrees  (0-360). 

Altitude  (km):  The  platform’s  altitude  in  kilometers  above  the 

Earth’s  surface. 

S4  Skymap  Output  Resolution:  Eor  a  given  Platform  Position,  the  following  settings  control 
the  skymap  output  resolution  in  azimuth  and  elevation. 

Delta  Azimuth(Deg):  Degrees  per  step  in  azimuth.  Permitted  input 
range  is  1.0  to  36.0  and  the  value  will  be  adjusted 
internally  to  create  an  integer  number  of  steps. 

Delta  Sin(Elevation):  Elevation  step  size  expressed  in  units  of 

sin(elevation).  Permitted  input  range  is  0.01  to  0.10 
and  the  value  will  be  adjusted  internally  to  create  an 
integer  number  of  steps. 

Notes:  (1)  The  Data  Tool  and  Grid  Tool  are  not  active  for  the  lONSClNT-G  science  module. 

The  calculation  is  performed  using  the  grid  defined  in  the  S4  Skymap  Output 
Resolution  section  defined  above.  However,  Data  Probes  available  via  the 
lONSClNT-G  Graphical  Module  can  be  used  to  view  details  in  S4  as  a  function  of 
fixed  azimuth  and  elevation  in  1  -D  viewports 

(2)  The  File  menu  Save  Model/Open  Model  features  work  only  when  the  Retain 
Generated  Random  Number  Seed  Between  Runs  or  Specify  and  Retain  Random 
Number  Seed  option  has  been  used. 

lONSCINT-G  Outputs 

The  lONSClNT-G  science  module  returns  2D  Gridded  Data  Sets  with  the  S4  scintillation 
parameter  for  plotting  in  skymaps  representing  the  view  (in  azimuth  and  elevation)  from  a 
stationary  platform  position.  The  S4  scintillation  index  is  a  normalized  standard  deviation  of  the 
signal  intensity  (dimensionless).  S4  index  skymaps  can  be  viewed  in  Spectral  viewports  using 
the  lONSClNT-G  Graphical  Module.  To  prepare  an  active  graphics  window  for  viewing  the  S4 
scintillation  skymaps,  use  the  Viewport  menu  to  select  Spectral  under  the  Projection  option. 

Note  that  the  lONSClNT-G  Graphical  Module  also  provides  data  probes  for  viewing  the  S4 
parameter  as  a  function  of  fixed  azimuth  and  elevation  values  in  1-D  viewports. 

Hint:  To  produce  realistic  S4  scintillation  time  profiles  for  a  given  platform-satellite  link,  this 
science  module  should  be  run  in  dynamic  mode  for  a  time  period  using  a  fixed  Platform  Position 
with  a  variety  oi Scintillation  Database  Options  settings.  The  user  should  examine  the  resulting 
skymap  sequences  to  select  a  suitable  S4  scenario  and  then  run  the  lONSClNT-G  Application 
Module  using  the  lONSClNT-G  Science  Module  input  settings  for  that  scenario  along  with  those 
of  the  satellite  of  interest.  This  will  enable  the  generation  of  ID  plots  of  the  S4  scintillation  index 
vs.  time  for  the  desired  platform-satellite  link. 
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The  IRI2007  Science  Module 


Model  Name: 

Version: 

Developer: 

Referenees: 


International  Referenee  Ionosphere  (IRI)  Model  2007 
May  2007 

IRI  is  sponsored  by  the  Committee  on  Spaee  Researeh  (COSPAR)  and  the 
Union  Radio  Seientilique  Internationale  (URSI).  Code  provided  by 
NASA’s  Space  Physics  Data  Facility  and  the  National  Space  Science  Data 
Center  via  FTP  (http://iri.gsfc.nasa.gov/). 

Araujo-Pradere,  E.  A.,  T.  J.  Fuller-Rowell,  and  M.  V.  Codrescu,  STORM: 
An  empirical  storm-time  ionospheric  correction  model,  1 ,  Model 
description,  Radio  Set,  37(5),  1070,  doi:10.1029/2001RS002467  (2002) 

Bilitza,  D.,  International  Reference  Ionosphere  2000,  Radio  ScL,  36(2), 
261-275  (2001) 

Bilitza,  D.,  A  correction  for  the  IRI  topside  electron  density  model  based 
on  Alouette/ISIS  topside  sounder  data,  A Jv.  Space  Res.,  33(6),  838-843 
(2004) 

Bilitza,  D.,  S.  Radicella,  B.  Reinisch,  J.  Adeniyi,  M.  Mosert  de  Gonzalez, 
S.  Zhang,  and  O.  Obrou,  New  Bq  and  Bi  models  for  IRI,  Adv.  Space  Res., 
25(1),  89-96  (2000) 

Bilitza,  D.,  and  B.  Reinisch,  International  Reference  Ionosphere  2007: 
Improvements  and  new  parameters,  J.  Adv.  Space  Res.,  42(4),  599-609, 
doi:I0.I0I6/j.asr.2007.07.048  (2008) 

CCIR,  Atlas  of  ionospheric  characteristics.  Comite'  Consultatif 
International  des  Radiocummnications,  Report  340-4,  International 
Telecommunication  Union,  Geneva  (1967) 

Coisson,  P.,  S.M.  Radicella,  R.  Leitinger,  B.  Nava,  Topside  electron 
density  in  IRI  and  NeQuick:  features  and  limitations,  Adv.  Space  Res., 
37(5),  75-79  (2006) 

Coisson,  P.,  B.  Nava,  and  S.M.  Radicella,  On  the  use  of  NeQuick  topside 
option  in  IRI-2007,  A  Jv.  Space  Res.,  43,  1688-1693  (2009) 

Danilov,  A.  D.,  and  V.  K.  Semenov,  Relative  ion  composition  model  at 
midlatitudes,  J.  Atmos.  Terr.  Rhys.,  40,  1093-1102  (1978) 

Danilov,  A.  D.,  and  A.  P.  Yaichnikov,  A  new  model  of  the  ion 
composition  at  75  km  to  1000  km  for  IRI ,  Adv.  Space  Res.,  5(1),  75-79 
(1985) 

Danilov,  A.,  A.  Rodevich,  andN.  Smirnova,  Problems  with  incorporating 
a  new  D-region  model  into  the  IRI,  Adv.  Space  Res.,  15,  I65-I69  (1995) 

Danilov,  A.,  and  N.  Smirnova,  Improving  the  75  km  to  300  km  ion 
composition  model  of  the  IRI,  AJv.  Space  Res.,  15,  I7I-I78  (1995) 
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DuCharme,  E.,  L.  Petrie,  and  R.  Eyfrig,  A  method  for  predieting  the  Fl- 
layer  eritical  frequency,  Radio  Set,  6,  369-378  (1971) 

DuCharme,  E.,  E.  Petrie,  and  R.  Eyfrig,  A  method  for  predicting  the  Fl- 
layer  critical  frequency  based  on  Zurich  smoothed  sunspot  number.  Radio 
Sci,  8,  837-839  (1973) 

Fuller-Rowell,  T.,  E.  Araujo-Pradere,  and  M.  Codrescu,  An  empirical 
ionospheric  storm-time  correction  model,  A  Jv.  Space  Res.,  25(1),  139-148 
(2000) 

Gulyaeva,  T.,  Progress  in  ionospheric  informatics  based  on  electron 
density  profde  analysis  of  ionograms,  A  Jv.  Space  Res.,  7(6),  39  (1987) 

Eiu,  R.Y.,  P.A.  Smith,  and  J.W.  King,  A  new  solar  index  which  leads  to 
improve  foF2  predictions  using  the  CCIR-Atlas,  Telecommunications 
Journal,  50,  408-414  (1983) 

Radicella,  S.  M.,  and  R.  Eeitinger,  The  evolution  of  the  DGR  approach  to 
model  electron  density  profdes,  A Jv.  Space  Res.,  27(1),  35-40  (2001) 

Scotto,  C.,  M.  Mosert  de  Gonzalez,  S.  Radicella,  and  B.  Zolesi,  On  the 
prediction  of  the  Fi  ledge  occurrence  and  critical  frequency,  Adv.  Space 
Res.,  20(9),  1773-1776  (1997) 

Scotto,  C.,  S.  Radicella,  and  B.  Zolesi,  An  improved  probability  function 
to  predict  the  Fi  layer  occurrence  and  E  condition.  Radio  ScL,  33,  1763- 
1765  (1998) 

Truhlik,  V.,  E.  Triskova,  and  J.  Smilauer,  A  empirical  model  of  ion 
composition  in  the  outer  ionosphere,  Adv.  Space,  Res.,  31,  653-663  (2003) 

Truhlik,  V.,  E.  Triskova,  and  J.  Smilauer,  New  advances  in  empirical 
modeling  of  ion  composition  in  the  outer  ionosphere,  Adv.  Space  Res.,  33, 
844-849  (2004) 

Truhlik,  V.,  E.  Triskova,  and  J.  Smilauer,  An  empirical  topside  electron 
density  model  for  calculation  of  absolute  ion  densities  in  IRI,  Adv.  Space 
Res.,  71(5),  928-934  (2006) 

Note:  It  is  recommended  that  AF-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

IRI2007  Overview 

The  1R12007  Science  Module  utilizes  the  International  Reference  Ionosphere  (IRI)  model  of 
2007,  an  empirical  model  specifying  monthly  averages  of  electron  density,  ion  composition, 
electron  temperature,  and  ion  temperature  in  the  altitude  range  50  to  1500  km  with  extrapolated 
output  up  to  2000  km  [Bilitza  and  Reinisch,  2008].  The  International  Reference  Ionosphere  (IRI) 
is  an  international  project  sponsored  by  the  Committee  on  Space  Research  (COSPAR)  and  the 
International  Union  of  Radio  Science  (URSI)  and  is  the  de  facto  international  standard  for 
climatological  specification  of  ionospheric  quantities.  Updated  frequently,  several  steadily 
improved  editions  of  the  model  have  been  released  over  the  years  based  on  major  data  sources 
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including  the  worldwide  network  of  ionosondes,  the  powerful  ineoherent  seatter  radars 
(Jieamarea,  Areeibo,  Millstone  Hill,  Malvern,  St.  Santin),  the  ISIS  and  Alouette  topside 
sounders,  and  in  situ  instruments  on  several  satellites  and  rockets  (see  http://iri.gsfc.nasa.gOv/I. 
While  IRI  is  eapable  of  speeifying  a  variety  of  other  quantities,  the  AF-GEOSpace 
implementation  calculates  only  eleetron  density,  neutral,  ion,  and  eleetron  temperatures  and  ion 
densities  (O^,  H^,  He^,  0^2,  NO^,  andN"^). 

IRI2007  Inputs 

The  IRI2007  Seienee  Module  requires  the  following  inputs: 

Global  Parameters:  Year,  Day,  UT 

Note:  Input  values  for  FIO.  7  and  Ap  are  read  direetly  from  the  file 
$AFGS_HOME/models/data/IRI2007/ap.dat.  Eile  updates  are  made 
available  periodically  via  FTP.  The  values  entered  in  the  Globals  input 
section  are  not  utilized. 

Required  Data  files:  IRI2007  retrieves  all  input  quantities  (except  for  the  time)  from  data  files 

found  in  folder  $AFGS_HOME/models/data/IRI2007,  namely 

dgrf##.dat,  igrfD5.dat,  igrfD5s.dat:  Definitive  IGRF  and  IGRF  eoeffieients 
for  the  years  1945-2010  (##  =  two-digit  year) 

CCIR##.ase:  Coeffieient  files  for  the  CCIR  model  (##  =  month  +10) 

URSI##.aso:  Coeffieient  files  for  the  URSI  model  (##  =  month  +  10) 

ig_rz.dat:  File  eontains  (1)  the  ionospheric  index  (IG12)  based  on 

foF2  measurements  from  a  dozen  ionosondes  eorrelated 
with  CCIR  foF2  maps  [Liu  et  al,  1983]  and  (2)  the  12- 
month  running  mean  of  sunspot  number  (RzI2)  for 
1958  thru  2013.  If  a  date  outside  this  range  is  used,  no 
valid  output  will  be  generated  and  all  output  quantities 
will  be  set  to  values  of  -1.  File  updates  are  made 
available  periodieally  via  FTP. 

ap.dat:  Contains  3-hour  magnetic  index  and  FIO. 7  daily 

index  from  1958  thru  Feb  2011.  If  a  date  outside  this 
range  is  used,  then  the  H/i-dependent  “foF2  storm 
model”  [Fuller-Rowell  et  al,  2000;  Amujo-Pradere  et 
al,  2002]  will  be  turned  off.  File  updates  available 
periodieally  via  FTP. 

The  eight  input  options  offered  below  were  chosen  from  a  larger  list  of  available  IRI  options  on 
the  basis  of  likelihood  of  seleetion  as  well  as  their  lack  of  additional  input/database  requirements. 

Bottomside  Thickness:  The  bottomside  thickness  can  be  specified  two  ways: 

Internal  table:  This  coefficient  table  (Bo)  is  based  on  ineoherent  scatter 

data  [see  Bilitza  et  al,  2000]. 

Gulyaeva  model:  The  Gulyaeva  model  is  based  on  ionosonde  data  mostly 
from  mid-latitiudes  [Gulyaeva,  1987]. 
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F  Layer: 


Global  representation  of  the  F2  peak  parameters  (FoF2,  M3000)  are 
available  from  two  models: 


URSI  model:  Model  of  the  International  Union  of  Radio  Seienee 

(URSI) 

CCIR  model:  Model  of  the  Comite'  Consultatif  International  des 

Radioeummnioations  (CCIR)  {CCIR,  1967] 

The  CCIR  model  is  reeommended  for  the  eontinents  and  the  URSI  model 

for  the  oeean  areas.  If  a  single  model  is  needed  globally  then  the  URSI 

model  is  reeommended. 

Ion  Composition:  Ion  eomposition  representation  is  available  from  one  of  two  sets  of 

models. 

DS-95  and  TTS-03:  The  models  of  Danilov-Smirnova  {Danilov  and 
Smirnova,  1995]  and  Truhlik,  Triskova,  Smilauer 
{Truhlik  et  al,  2003]  will  be  used. 

DS-78  and  DY-85:  The  models  of  Danilov  and  Semenov  [1978]  and 
Danilov  and  Yaichnikov  [1985]  will  be  used. 

Te  caleulation:  The  electron  temperature  can  be  specified  two  ways. 

Standard:  Use  the  standard  electron  temperature  description 

Te/Ne  correlation:  Use  electron  temperature  based  on  correlation  with 
density. 

Ne  calculation:  The  electron  density  can  be  specified  two  ways. 

Standard:  Use  the  standard  electron  density  description. 

Lay-functions:  Use  normalized  electron  density  using  lay-functions. 

FI  calculation:  The  FI  plasma  frequency  can  be  specified  two  ways  {Bilitza,  2001]. 

Standard:  The  frequency  foFl  is  from  the  IRI-95  model 

{DuCharme  et  al,  1971,  1973] 

L-condition  transitions:  This  option  adds  the  so-called  L-condition 

transitions  developed  by  et  al.  [1997,  1998]. 

Topside  Ne  calculation:  Two  options  are  available  for  the  topside  electron  density  profile. 

Intercosmos:  The  Intercosmos-based  topside  model  based  on  Truhlik 

et  al.  [2006]. 

Te  tops  (Aero,  ISIS):  The  standard  IRI  model  based  on  Aeros/ISIS  data. 

Topside  Te  calculation:  Topside  electron  density  profile  computation  can  be 

NeQuick:  The  topside  model  based  on  Radicella  and  Leitinger 

[2001]  and  Coisson  et  al.  [2006]  is  used. 

TTS:  The  topside  model  based  on  Truhlik  et  al.  [2006]  is 

used. 
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Corrected  IRI  2001 :  Correction  factors  from  Bilitza  [2004]  are  used  within 
the  original  2001  topside  model. 

Original  IRl  2001;  The  original  2001  model  is  used. 

Note:  The  code  implementation  within  the  lRl-2007  Science  Module  follows  all  default  option 
settings  of  the  original  FORTRAN  code.  For  completeness,  options  not  offered  above  but  which 
are  accessible  in  the  original  code  are  listed  here  along  with  their  default  settings.  Chart  notation 
comes  directly  from  file  irisub.for  acquired  via  the  FTP  code  source. 

.True.  .False.  default 


Ne  computed 

Ne  not  computed 

true 

Te, 

Ti  computed 

Te,  Ti  not  computed 

true 

Ne  & 

Ni  computed 

Ni  not  computed 

true 

Ne  - 

Tops ; 

;  fl0.7<188 

flO.7  unlimited 

true 

foF2 

from 

model 

foF2  or  NmF2  -  user  input 

true 

hmF2 

from 

model 

hmF2  or  M3000F2  -  user  input 

true 

foFl 

from 

model 

foFl  or  NmFl  -  user  input 

true 

hmFl 

from 

model 

hmFl  -  user  input  (only  Lay  version) 

true 

foE 

from 

model 

foE  or  NmE  -  user  input 

true 

hmE 

from 

model 

hmE  -  user  input 

true 

Rzl2 

from 

file 

Rzl2  -  user  input 

true 

IGRF 

dip. 

magbr,  modip 

old  FIELDG  using  POGO68/10  for  1973 

true 

FI  probability  model 

critical  solar  zenith  angle  (old) 

true 

ion 

drift 

computed 

ion  drift  not  computed 

false 

ion 

densities  in  % 

ion  densities  in  m-3 

true 

D-region : 

IRI-95 

Special:  3  D-region  models 

true 

F107D  from  AP . DAT 

F107D  user  input  (oarr(41)) 

true 

foF2 

storm  model 

no  storm  updating 

true 

IG12 

from 

file 

IG12  -  user  input 

true 

spread-F  probability 

not  computed 

false 

IRI2007  Outputs 

The  1R12007  Science  Module  returns  3D  Gridded  data  sets  of  electron  density  (#/m  ), 
temperatures  (°K)  of  neutrals,  ions,  and  electrons,  and  densities  of  O"^,  H"^,  He"^,  02^,  NO"^,  and 
N". 
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The  ISPM  Science  Module  (V2.5.1  and  Static  Only) 

Model  Name:  Interplanetary  Shoek  Propagation  Model  (ISPM) 

Version:  94 

Developer:  M.  Dryer  and  Z.  Smith,  NOAA  Spaee  Environment  Center 

Referenees:  Fry,  C.  D.,  M.  Dryer,  Z.  Smith,  W.  Sun,  C.S.  Deehr,  and  S.-I.  Akasofu, 

Foreeasting  solar  wind  structures  and  shock  arrival  times  using  an 
ensemble  of  models,  J.  Geophys.  Res.,  108{A2),  1070, 
doi:10.1029/2002JA009474  (2003) 

Hilmer,  R.V.,  G.P.  Ginet,  K.  Kadinsky-Cade,  S.  Quigley,  D.T.  Decker, 
P.H.  Doherty,  Space  Environment  Models  Addressing  Operational 
Hazards:  An  AF-GEOSpace  Perspective  on  Current  Capabilities, 
American  Institute  of  Aeronautics  and  Astronautics,  AIAA  2000-0366, 
from  38th  Aerospace  Sciences  Meeting,  10-13  January  2000,  Reno  NV, 
2000. 

Smith,  Z.  and  M.  Dryer,  The  Interplanetary  Shock  Propagation  Model:  A 
Model  for  Predicting  Solar-Flare-Caused  Geomagnetic  Storms,  Based  on 
the  2  1/2  D,  MHD  Numerical  Simulation  Results  from  the  Interplanetary 
Global  Model  (2D  IGM),  NOAA  Tech.  Mem.  ERL  SEL-89,  (1995) 

Note:  It  is  recommended  that  AF-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

ISPM  Overview 

The  Interplanetary  Shock  Propagation  Model  (ISPM)  was  developed  to  estimate  the 
characteristics  of  interplanetary  shocks  caused  by  energetic  solar  events.  We  hereafter  refer  to 
these  shock-producing  solar  events,  whether  they  are  coronal  mass  ejections  or  solar  flares,  as 
“solar  flares”  since  flare  data  are  a  crucial  input  to  the  model.  This  description  of  ISPM  is 
excerpted  from  the  User’s  Manual: 

“The  ISPM  program  calculates  the  arrival  time  and  strength  at  1  AU  of  a  shock  from  a 
solar  flare.  The  shock  strength  is  characterized  by  the  jump  in  dynamic  pressure  across 
the  shock  front:  this  parameter  is  used  to  estimate  the  likelihood  of  the  shock  being  geo- 
effective.  The  arrival  time  and  strength  are  calculated  from  algebraic  equations  derived 
from  a  parametric  study  of  solar-caused  interplanetary  shocks  that  was  made  using  [two- 
dimensional  magnetohydrodynamic]  simulations.” 

ISPM  is  based  on  magnetohydrodynamic  computations  of  a  shock  wave  initiated  at  the  Sun  that 
propagates  through  a  normal  solar  wind.  The  initial  energy  of  the  shock  is  estimated  by  a 
formulation  based  on  the  X-ray  energy  output  of  a  solar  flare  and  the  associated  speed  derived 
from  the  Type  II  frequency  drift  rate.  The  angular  extent  of  the  shock  wave  from  the  presumed 
solar  flare  location  is  a  function  of  the  energy  estimated  by  this  formulation. 

As  input,  the  ISPM  requires  specification  of  the  flare  location,  start  time  of  the  shock,  shock 
driver  duration,  and  initial  shock  speed.  The  flare  location  (solar  latitude  and  longitude)  is 
obtained  from  H-alpha  observations  made  by  USAF  SOON  sites.  The  shock  start  time  is  defined 
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as  the  onset  time  of  the  Type  II  radio  burst  assoeiated  with  the  flare  as  observed  by  the  USAF 
RSTN  sites.  Initial  shoek  speed  is  set  to  the  Type  II  drift  speeds  estimated  by  the  RSTN  sites. 
Shock  duration  times  can  either  be  directly  input  or  estimated  from  the  decay  time  of  the  soft  X- 
ray  event  associated  with  the  solar  flare.  If  the  X-ray  level  option  is  chosen,  the  ISPM  assumes 
the  shock  driver  end  time  to  be  the  time  at  which  the  logarithm  of  the  magnitude  of  the  GOES 
satellite  1-8  Angstrom  X-ray  signal  falls  to  one -half  the  logarithm  of  the  peak  value  observed  for 
the  event. 

For  output,  the  ISPM  gives  the  predicted  transit  time  (TT)  of  the  shock  from  Sun  to  Earth  and  its 
strength  in  terms  of  the  dynamic  pressure  jump  (DPI)  across  the  shock  front  and  the  shock 
strength  index  (SSI).  According  the  ISPM  User’s  Manual,  the  SSI  “is  based  on  the  difference  of 
(the  log  10  of)  the  DPI  from  the  [background]  state  used  in  the  numerical  modeling  study.”  If  the 
SSI  is  greater  than  or  equal  to  zero  then  the  shock  will  likely  be  geo-effective.  If  SSI  is  less  than 
-1  there  will  likely  be  no  measurable  effects.  TT  and  DPI  are  provided  by  numerical  algorithms 
relating  TT  and  DPI  to  total  net  energy  (E)  input  by  the  solar  source  into  the  interplanetary 
medium  as  a  function  of  angular  separation  (j)  between  observer  and  solar  source.  The  algorithms 
were  constructed  in  algebraic  form  from  a  parametric  study  that  used  representative 
combinations  of  the  shock  starting  velocity  and  starting  pulse  width  and  duration. 

The  range  of  applicability  is  given  by  Smith  and  Dryer  [1994]  as  follows. 

Solar  flare  input  energy,  E  E> 

Angular  distance  of  pulse  central  meridian  from  Earth-sun  line,  (j)  -90  deg  <  (j)  <  80  deg 

Transit  time,  TT  IT  <  120  hours 

The  flare  input  energy  can  be  estimated  from  the  pulse  duration  time  Td  and  the  initial  shock 
speed  Vs  according  to  the  formula,  E  =  C*co*(7ii  +£))*(F5^)  with  C=2.83e+19  erg/(m^  s^  deg),  the 
pulse  longitudinal  width  co=60  degrees,  and  £>=0.52  hours.  Total  energy  is  assumed  to  be 
proportional  to  kinetic  energy  flux,  i.e.,  The  spatial  input  pulse  shape  is  a  sine  curve  of  width 
CO,  where  the  area  under  the  sine  curve  is  proportional  to  co.  The  temporal  input  pulse  has  a  flat 
section  of  width  Td  with  1-hour  ramps  at  the  beginning  and  end  of  the  pulse. 

ISPM  Inputs 

The  ISPM  science  module  requires  the  following  inputs: 

Global  Parameters:  Year,  Day,  UT  (used  to  initialize  event  onset  and  end  times) 

Specify  Event  Duration:  The  user  can  choose  to  specify  either  the  Stop  Time  of  the  event,  the 

Duration  of  the  event,  or  have  the  event  duration  estimated  from  inputs  of 
the  associated  GOES  soft  X-ray  Levels . 

Event  onset  time:  Time  of  onset  of  Type  II  radio  burst  from  USAF  RSTN  site  in  the  format 

MM/DD/YY  HH:MM. 

Event  end  time:  When  Stop  Time  is  selected  to  specify  the  event  duration,  the  user  inputs 

here  the  event  end  time  in  the  format  MM/DDWY  HH:MM.  GOES 
satellite  X-ray  levels  are  not  used  to  estimate  the  event  duration.  The 
ISPM  resets  any  duration  greater  than  2  hours  to  2  hours. 
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When  Duration  is  selected  to  specify  the  event  duration  the  user  inputs  the 
event  duration  in  hours  here.  GOES  satellite  X-ray  levels  are  not  used  to 
estimate  the  event  duration.  The  ISPM  resets  any  duration  greater  than  2 
hours  to  2  hours. 

When  X-ray  Levels  is  selected  to  specify  the  event  duration,  the  user 
inputs  here  the  background  X-ray  level  measured  by  the  1-8  Angstrom  X- 
ray  instrument  on  a  GOES  satellite  before  the  event  occurred.  These 
values  are  entered  with  a  classification  letter  and  a  numeric  field.  The 
usual  X-ray  event  classification  letters  A,  B,  C,  M,  or  X  can  be  used  with 
the  numeric  field  consisting  of  1-3  characters  which  may  be  digits  or  an 
optional  decimal  point.  The  numeric  field  multiplies  the  flux  level.  The 
range  of  allowed  values  is  A1  through  X99. 

When  X-ray  Levels  is  selected  to  specify  the  event  duration,  the  user 
inputs  here  the  peak  X-ray  level  measured  by  the  1-8  Angstrom  X-ray 
instrument  on  a  GOES  satellite  during  the  X-ray  event.  The  format  is  the 
standard  X-ray  event  classification  scheme  as  explained  above.  After 
entering  this  value  the  user  should  click  in  the  Decay  time  box  and  the 
level  corresponding  to  1/2  log  of  the  peak  signal  will  be  displayed  next  to 
this  box. 

Decay  time,  level  XN.N:  When  A-ray  Levels  is  selected  to  specify  the  event  duration  the  user 

inputs  here  the  time  in  the  format  MM/DD/YY  HH:MM  at  which  the  X- 
ray  level  measured  by  the  1-8  Angstrom  X-ray  instrument  on  a  GOES 
satellite  during  the  X-ray  event  decays  to  the  level  XN.N.  The  level  XN.N 
is  calculated  from  the  Backg.  Class,  and  Peak.  Class.  Of  course,  this  time 
will  occur  after  the  peak  of  the  X-ray  event. 

Type  II  speed  (km/s):  The  Type  II  drift  speed  in  km/s  calculated  by  the  USAE  RSTN  network 
from  observations  of  Type  II  radio  bursts.  This  value  must  be  greater  than 
0  and  less  than  10000  km/s. 

Elare  lat.  (deg  N):  The  solar  latitude,  between  -90°  and  +90°  North,  of  the  solar  flare 

associated  with  the  Type  II  radio  burst.  This  information  can  be  obtained 
from  H-alpha  observations  by  the  USAE  SOON  sites.  Degrees  South  are 
entered  as  negative  numbers.  ISPM  does  not  use  this  input. 

Elare  Ion.  (deg  W).:  The  solar  longitude,  between  -180°  and  +180°  West,  of  the  solar  flare 

associated  with  the  Type  II  radio  burst.  This  information  can  be  obtained 
from  H-alpha  observations  by  the  USAE  SOON  sites.  Degrees  East  are 
entered  as  negative  numbers.  Note:  Elare  locations  beyond  the  limb  are 
unrealistic. 

Event  in  previous  24  hours?:  If  the  user  checks  this  box  then  the  following  guidelines  concerning 

the  interpretation  of  the  ISPM  are  displayed  in  a  text  window: 

If  an  event  has  occurred  in  the  previous  24  hours,  you  need  to  check  for  the  possibility  of 
interaction  of  the  shock  from  this  event  with  that  from  the  previous  event. 
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Event  duration: 


Backg.  Class: 


Peak.  Class: 


If  the  first  shock  arrives  well  before  the  expected  arrival  of  the  second  shock,  the  first 
shock  is  independent.  If  not,  you  need  to  look  at  the  relative  spacing  of  sources  in  space 
and  time. 

If  the  source  of  the  first  shock  (FI)  is  within  25  deg  of  Central  Meridian  (CM)  [the  Earth- 
Sun  line]  its  reverse  shock  (Rl)  will  interact  with  the  forward  shock  of  the  following 
event  (F2).  If  Rl  is  strong  enough,  F2  may  be  significantly  weakened  or  even  annihilated 
in  the  interaction.  In  this  case,  FI  may  travel  independently  to  lAU.  (Note:  reverse 
shocks  form  some  5-10  hours  after  initiation  of  a  flare.  If  the  time  interval  between  the 
two  flares  is  too  short,  the  reverse  shock  may  not  have  had  time  to  form). 

If  not,  FI  is  likely  to  be  overtaken.  In  this  case,  the  ISPM  prediction  does  not  apply  to 
either  FI  orF2. 

The  shock  from  the  second  event  (F2)  will  be  independent  if: 

1.  F2  is  significantly  faster  than  FI,  its  source  is  located  closer  to  CM  than  FI  and  it  starts 
soon  after  FI  (within  a  few  hours). 

2.  F2  travels  independently  for  the  majority  of  its  transit  time  to  Earth.  That  is: 

a.  It  does  not  encounter  Rl  (source  of  FI  is  >30  deg  from  CM). 

b.  It  does  not  travel  through  the  high-speed  wake  of  FI. 

In  case  2. a,  an  encounter  with  a  reverse  shock  will  weaken  or  annihilate  a  fast  forward 
shock.  The  exact  nature  of  the  resultant  of  the  interaction  depends  on  the  relative  strength 
of  the  interacting  shocks.  In  case  2.b,  traveling  through  the  disturbed  (high  speed,  low 
density)  wake  of  a  preceding  fast  forward  shock  will  accelerate  the  following  shock. 

If  a  prediction  for  the  previous  event  is  not  available  you  can  get  it  by  running  ISPM  for 
it  separately. 

Display  Text:  Clicking  this  button  will  display  the  text  output  window  if  currently  closed. 

ISPM  Outputs 

ISPM  returns  a  text  message  window  containing  the  results  of  the  model  calculations  and  a 
summary  of  the  input  parameters.  The  model  outputs  are: 

Time  of  shock  arrival  at  Earth  in  the  format  YYYY  MM  DD  HHMM  (Zulu) 

Total  propagation  time  in  the  format  HH  MM 

Shock  Strength  (the  dynamic  pressure  jump,  DPJ)  in  units  of  dynes/cm^ 

In  addition,  ISPM  computes  the  shock  strength  index  (SSI)  based  on  the  difference  of  (the  loglO 
of)  the  DPJ  from  the  [background]  state  used  in  the  numerical  modeling  study.  If  the  SSI  is 
greater  than  or  equal  to  zero  then  the  shock  will  likely  be  geo-effective.  If  SSI  is  less  than  -1 
there  will  likely  be  no  measurable  effects. 
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The  MAGNETOPAUSE  Science  Module 


Model  Name:  Magnetopause 

Version:  9  Aug  2009 

Developer:  Air  Foree  Researeh  Laboratory  (based  on  the  magnetopause  loeation  eode 

of  N.  A.  Tsyganenko;  GEOPACK-2008  software  version  21  April  2008) 

References:  Jerab,  M.,  Z.  Nemecek,  J.  Safrankova,  K.  Jelinek,  and  J.  Merka,  Improved 

bow  shock  model  with  dependence  on  the  IMF  strength,  Planet.  Space 
Set,  53,  85-93  (2005) 

Lin  et  ah,  Comparison  of  a  new  model  with  previous  models  for  the  low- 
latitude  magnetopause  size  and  shape,  Chinese  Sci.  Bull,  55:  179-187,  doi: 
10.1007/sl  1434-009-0533-4  (2010) 

Shue,  J.-H.,  P.  Song,  C.T.  Russell,  J.T.  Steinberg,  J.K.  Chao,  G.  Zastenker, 
O.L.  Vaisberg,  S.  Kokubun,  HJ.  Singer,  T.R.  Detman,  and  H.  Kawano, 
Magnetopause  location  under  extreme  solar  wind  conditions,  J.  Geophys. 
Res.,  103  (A8),  17,691-17,700  (1998) 

Shue,  J.-H.,  P.  Song,  C.T.  Russell,  J.K.  Chao,  and  Y.-H.  Yang,  Toward 
predicting  the  position  of  the  magnetopause  within  geosynchronous  orbit, 
J.  Geophys.  Res.,  105  (A2),  2641-2656  (2000) 

Shue,  J.-H.,  C.T.  Russell,  and  P.  Song,  Shape  of  the  low-latitude 
magnetopause:  Comparison  of  models,  AJv.  Space  Res.,  25,  1471-1484 
(2000) 

Shue,  J.-H.,  and  P.  Song,  The  location  and  shape  of  the  magnetopause. 
Planet.  Space  Sci,  50,  549-558  (2002) 

Tsyganenko,  N.A.,  S.B.P.  Karlsson,  S.  Kokubun,  T.  Yamamoto,  A.J. 
Lazarus,  K.W.  Ogilvie,  C.T.  Russell,  and  J.A.  Slavin,  Global 
configuration  of  the  magnetotail  current  sheet  as  derived  from  Geotail, 
Wind,  IMP  8  and  ISEE  1/2  data,  J.  Geophys.  Res.,  103  (A4),  6827-6841, 
(1998) 

Yang,  Y.-H.,  J.K.  Choa,  C.-H.  Ein,  J.-H.  Shue,  X.-Y.  Wang,  P.  Song,  C.T. 
Russell,  R.P.  Lepping,  and  A.J.  Eazarus,  Comparison  of  three 
magnetopause  prediction  models  under  extreme  solar  wind  conditions,  J. 
Geophys.  Res.,  107  (Al),  1008,  10.1029/2001JA000079  (2002) 

Note:  It  is  recommended  that  AE-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

Magnetopause  Overview 

Solar  wind  interaction  with  the  Earth’s  internal  magnetic  field  forms  a  magnetic  cavity  called  the 
magnetosphere.  The  outer  boundary  of  this  cavity  is  called  the  magnetopause  which  is  shaped  by 
interactions  of  the  internal  fields  and  particle  populations  of  the  magnetosphere  with  the 
streaming  solar  wind  particles  and  the  Interplanetary  Magnetic  Eield  (IME)  flowing  past  the 
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Earth.  The  magnetopause  boundary  is  the  loeation  where  mass,  energy,  and  momentum  from  the 
solar  wind  are  exehanged  with  the  magnetosphere.  As  a  result,  the  eharaeteristies  of  the  magnetie 
field  and  eharged  partiele  populations  ean  be  extremely  different  on  either  side  of  this  boundary, 
e.g.,  the  magnetie  field  eomponent  perpendieular  to  the  geosynehronous  orbit  plane  ean  ehange 
sign  abruptly  as  a  spaeeeraft  erosses  the  magnetopause.  Charaeteristies  of  the  eharged  partiele 
populations  ean  also  vary  rapidly  aeross  this  boundary.  To  assist  with  determining  spaeeeraft 
loeation  relative  to  this  important  physieal  boundary,  the  MAGNETOPAUSE  Seienee  Module 
speeifies  the  loeation  of  the  Earth’s  magnetopause  boundary  using  the  model  of  Shue  et  al. 

[1998]  whieh  is  driven  by  solar  wind  dynamie  pressure  and  the  z-eomponent  of  the  IME.  The 
basie  output  of  the  model  is  the  distanee  measured  in  Earth  radii  to  the  magnetopause  boundary 
so  it  ean  be  used  to  estimate  the  timing  of  spaeeeraft  magnetopause  erossings. 

Magnetopause  Inputs 

The  Magnetopause  seienee  module  requires  the  following  inputs: 

Global  Parameters:  Year,  Day,  UT 

The  Solar  Wind  seetion  allows  the  user  to  speeify  how  the  solar  wind  input  will  be  eharaeterized. 
Input  text  boxes  will  aetivate  aeeording  to  the  ehosen  method.  Note  that  the  default  settings 
represent  typieal  solar  wind  eonditions  and  that  all  methods  require  the  same  Interplanetary 
Magnetie  Eield  (IMP)  information.  The  three  options  are: 

Veloeity  +  Density:  The  Velocity  +  Density  option  requires  input  of  the  following  quantities: 

VGSE-X  (km/s),  VGSE-Y  (km/s),  and  VGSE-Z  (km/s)  are  the  GSE  X,  Y, 
and  Z  veloeity  eomponents  of  the  solar  wind.  In  the  Geoeentrie  Solar 
Eeliptie  (GSE)  eoordinate  system,  the  X  axis  points  from  the  Earth  to  the 
Sun  (thus  VGSE-X  (km/s)  <  0),  the  Z  axis  is  perpendieular  to  the  eeliptie 
plane  (positive  towards  north),  and  the  Y  axis  eompletes  the  right-handed 
system. 

SW-Density  (#/cm  )  is  the  solar  wind  proton  number  density. 

IMF-Bz(nT)  is  the  GSE  z-eomponent  of  the  IMP. 

Speed  +  Density:  The  Speed  +  Density  option  requires  input  of  the  following  quantities: 

SW-Speed  (km/s)  is  the  solar  wind  speed. 

SW-Density  (#/cm  )  is  the  solar  wind  proton  number  density. 

IMF-Bz(nT)  is  the  GSE  z-eomponent  of  the  IMP. 

Note  that  this  option  assumes  VGSE-X(km/s)  =  -[SW-Speed  (km/s)\  and 
VGSE-Y  (km/s)  =  VGSE-Z  (km/s)  =  0  to  determine  the  aberration  angle. 

Dynamie  Pressure:  The  Dynamic  Pressure  option  requires  input  of  the  following  quantities: 

SW-Press  (nPa)  is  the  solar  wind  dynamie  pressure  in  units  of  nanoPaseal. 

IMF-Bz(nT)  is  the  GSE  z-eomponent  of  the  IMP. 

Note  that  this  option  automatieally  sets  VGSE-X(km/s)  =  -400  km/s  and 
VGSE-Y  (km/s)  =  VGSE-Z  (km/s)  =  0  to  determine  the  aberration  angle. 
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GSW  Aberration  Correction:  Checked  by  default,  selecting  the  Add  29. 78  km/s  to  VGSE-Y hox 
assumes,  as  is  typically  the  case  in  available  data  sets,  that  the  value  used 
for  VGSE-Y  (km/s)  was  already  reduced  by  that  amount  in  order  to  account 
for  the  aberrations  caused  by  Earth’s  orbital  motion  around  the  Sun.  Note 
that  the  “Geocentric  Solar-Wind”  (GSW)  coordinate  system  is  analogous 
to  the  GSM  system  except  it’s  X-axis  is  align  anti-parallel  to  the  actual 
observed  direction  of  solar  wind  flow.  With  this  correction  selected  and 
given  average  solar  wind  conditions,  the  magnetopause  boundary  surface 
will  rotate  ~4°  about  the  GSE  Z-axis  such  that  the  magnetotail  swings 
toward  the  GSE-Y  direction. 

Magnetopause  Outputs 

The  MAGNETOPAUSE  Science  Module  returns  a  3D  Gridded  Data  Set  of  the  Distance 
measured  in  Earth  radii  to  the  magnetopause  boundary  with  positive  and  negative  values 
corresponding  to  points  inside  and  outside  the  magnetopause,  respectively.  A  summary  of 
selected  model  inputs  and  assumed  values  will  appear  listed  in  the  Model  Status  box. 
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The  METEOR  IMPACT  MAP  Science  Module 


Model  Name: 
Version: 
Developer: 
Referenees: 


Meteor  Impaet  Map  Model 
February  2004 

Radex,  Ine.  (now  AER,  Ine.)  and  the  Air  Force  Research  Laboratory 
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Note:  It  is  recommended  that  AF-GEOSpace  users  read  and  understand  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 


METEOR  IMPACT  MAP  Overview 

Meteors  enter  the  Earth’s  atmosphere  during  well-known  meteor  shower  periods,  as  well  as  at 
irregular  periods.  The  former  are  attributed  to  dust  released  by  comets  as  they  approach 
perihelion  (an  exception  to  this  statement  being  that  the  Geminids  arise  from  the  fragmentation 
of  Asteroid  Phaethon),  while  the  latter  represent  a  variety  of  sources,  such  as  cosmic  dust, 
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meteoroids  that  have  seattered  by  eollisions,  and  fragmentation  of  asteroids  and  meteorites 
following  eollisions  (see  Ceplecha  et  ah,  [1998]  and  Williams  &  Murad  [2002]  for  detailed 
introduetions).  In  total  about  40,000  tons  of  extraterrestrial  matter  are  eaptured  by  Earth 
annually,  most  of  whieh  disappears  during  reentry  due  to  the  high  temperatures  aehieved  due  to 
frietional  heating  \Love  &  Brownlee,  1993].  The  vaporization  proeess  oeeurs  primarily  in  the  E- 
region  of  the  ionosphere,  at  altitudes  between  130  and  90  km  (Cf  review  by  McNeil  et  al, 
[2002]).  The  meteor  showers  are  generally  quite  well  known  and  most  of  the  meteoroids  eonsist 
of  partieles  that  have  masses  in  the  range  1  pg  -  10  mg  with  a  peak  near  10  pg  [Love  & 

Brownlee,  1993]. 

The  extraterrestrial  matter  enters  the  Earth  at  high  veloeities  that  vary  between  12  km/s  and  70 
km/s,  the  exact  velocity  depending  on  the  relative  positions  of  Earth  in  its  orbit  and  of  the  dust 
cloud.  Because  of  this  high  velocity,  even  the  smallest  of  the  meteoroids  can  cause  severe 
damage  to  spacecraft  upon  impact.  The  damage  can  be  in  the  form  of  surface  damage 
(weakening  of  the  surface  through  formation  of  pits,  or  perhaps  penetration)  or  generation  of 
plasma  with  consequent  damage  to  electrical  systems  on  board  of  spacecraft.  This  module 
provides  several  pieces  of  information  that  are  useful  in  the  evaluation  of  meteoric  phenomena  as 
sources  of  anomalies  on  spacecraft. 

Two  important  characteristics  of  meteors  are  the  radiant  (the  point  where  the  backward 
projection  of  the  meteor  trajectory  intersects  the  celestial  sphere  or  more  generally,  the  point  in 
the  sky  where  meteors  from  a  specific  shower  seem  to  come  from)  and  the  Zenithal  Hourly  Rate 
(ZHR  -  the  number  of  shower  meteors  per  hour  one  observer  would  see  if  his  limiting  magnitude 
is  6.5,  and  if  the  radiant  is  in  the  zenith).  Generally,  the  known  showers  are  relatively  weak, 
corresponding  to  a  zenithal  hourly  rate  (ZHR)  of  200  or  less.  However,  occasionally  a  storm 
occurs  during  an  orbital  conjunction  of  the  Earth  and  cometary  dust.  In  those  cases,  the  ZHR 
may  be  as  high  as  10,000  for  a  short  time  (1-2  hours).  Another  important  characteristic  is  the 
visual  magnitude,  M,  of  a  meteor.  This  magnitude  is  an  arbitrary  visual  scale  related  to  the 
absolute  luminous  power  (I)  by  the  formula:  M  =  6.8  -  2.5  log[/],  where  I  is  given  in  watts 
radiated  by  the  meteor  (Opik,  quoted  by  McKinley  [1961]).  We  will  not  make  use  of  this  quantity 
in  this  part  of  the  meteor  module. 

The  Meteor  Impact  Map  Model  calculates  the  rate  of  meteor  impacts  on  a  user-specified  surface 
area  at  positions  outside  of  the  Earth's  atmosphere.  Eor  the  specified  date,  the  shower  database  is 
used  to  determine  the  active  showers,  their  intensity,  direction  of  travel,  and  mass  distribution 
characteristics.  The  “damage”  calculations  are  based  on  the  work  of  McDonnell  and  Sullivan 
[1991],  who  derived  material  penetration  formulas  based  on  the  size,  density  and  velocity  of  the 
incident  meteor  and  the  material  properties.  Given  the  user-selected  satellite  material  properties 
and  the  characteristics  of  each  active  shower,  the  minimum  meteor  mass  (for  each  shower) 
required  to  cause  the  specified  damage  is  calculated.  The  Love  and  Brownlee  [1993]  mass 
distribution  characteristics  are  used  to  determine  the  number  of  meteors  per  second  at  or  above 
this  mass  that  will  be  present.  This  flux  rate  is  then  multiplied  by  a  user-specified  surface  area  to 
determine  the  impact  rate.  The  effects  on  the  damage  of  varying  angles  of  meteor  impacts  on  the 
surface  is  ignored  due  to  the  satellite-specific  geometry  that  would  be  required  for  proper 
modeling.  By  assuming  all  meteor  impacts  are  exactly  perpendicular  to  the  surface,  this  gives 
the  “worst-case”  scenario.  Eor  the  “damage”  calculations,  the  Earth’s  shadowing  of  meteors  is 
included  in  the  model.  Meteor  showers  that  are  blocked  by  the  Earth  from  reaching  the  model's 
specific  grid  positions,  or  the  positions  along  a  satellite  path,  are  removed  from  the  impact  rate 
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calculation  at  those  points.  The  “flux  only”  ealeulations  are  an  extension  of  the  damage -type 
ealeulations.  Beeause  no  material  or  pit  depth  is  speeified,  the  seleetion  of  a  minimum  meteor 
mass  is  handled  in  a  different  manner.  A  method  has  been  derived  to  normalize  the  effeets  of  the 
varying  veloeities  between  the  different  showers.  This  method  relates  a  minimum  pressure-like 
value  imposed  by  impaeting  meteors  to  ealeulate  the  minimum  mass  for  eaeh  shower.  The  “flux- 
only”  ealeulations  do  not  take  into  aeeount  any  Earth-shadowing  of  the  meteor  showers. 

The  essential  part  of  the  meteor  model  eode  is  a  database  that  deseribes  the  annual  meteor 
showers.  Jenniskens  [1994]  produeed  a  set  of  parameterized  values  for  deseribing  50  annual 
meteor  showers  (note  that  these  differ  from  those  posted  by  the  International  Meteor 
Organization  at  www.imo.net).  Given  a  date  and  time,  the  shower  parameters  are  used  in 
Jenniskens'  equations  to  ealeulate  the  eurrent  intensity  and  radiant  position  (whieh  defines  the 
direetion  of  travel)  for  eaeh  of  the  eurrently  aetive  showers.  This  database  also  ineludes  eaeh 
shower’s  typieal  meteor  veloeity  and  partiele  size  distribution  parameter.  McBride  [1997]  made 
some  revisions  and  updates  to  this  database  of  shower  parameters.  A  fixed  set  of  parameters  has 
been  assigned  for  the  “sporadies”  shower,  though  without  a  radiant  position.  The  meteor  mass 
distribution  derived  by  Love  and  Brownlee  [1993]  is  used  for  oaleulating  the  number  of  meteors 
per  seeond  (flux)  at  or  above/below  a  eertain  mass,  depending  on  the  applieation.  When  a  user 
ineludes  an  optional  storm,  its  basie  oharaeteristies  are  based  on  the  assoeiated  shower. 

However,  the  intensity  of  the  storm  is  modeled  as  a  Gaussian  eurve,  reaehing  the  speeified 
maximum  ZHR  value  at  the  storm  peak  time,  and  dropping  off  towards  zero  symmetrieally 
before  and  after  the  peak. 

If  the  user  is  interested  in  examining  the  infiuenee  of  meteoroid  showers  on  spaeeeraft  orbits 
over  an  extended  period,  then  the  METEOR  IMPACT-APP  module  should  be  used. 

METEOR  IMPACT  MAP  Reference  Data 

Reference  materials  deseribing  annual  meteor  shower  activity  can  be  accessed  using  the  set  of 
three  buttons  at  the  top  of  the  Meteor  Impact  Environment  Window. 

Elux  Sums  The  Flux  Sums  button  displays  a  single  page  PDE  with  a  plot  of  "Annual 

Meteor  Shower  Elux  (#/meter  /s)"  for  a  typical  year.  Most  flux  peaks  are 
labeled  with  the  name  of  the  dominant  shower. 

ZHR  Sums  The  ZHR  Sums  button  displays  a  single  page  PDE  with  a  plot  of  "Zenithal 

Hourly  Rate  (ZHR)  Sum  of  Active  Showers"  and  a  plot  of  "Number  of 
Active  Showers"  for  a  typical  year.  Most  ZHR  sum  peaks  are  labeled  with 
the  name  of  the  dominant  shower. 

Annual  Shower  Table  The  Annual  Shower  Table  button  displays  a  text  dialog  (matching  Table  1) 
with  a  list  of  meteor  showers  with  basic  features,  i.e..  Shower  Name, 

Julian  Day  of  Year  (DOY)  Range,  Peak  Date,  Zenithal  Hourly  Rate  at  the 
peak  date  (i.e.,  ZHR@Peak),  Calendar  Date  Range,  and  velocity  (km/s). 
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TABLE  1 


Shower  Name  (DOY  Range) 

PeakDate 

ZHR@Peak 

Date  Range 

V (km/s) 

Bootids 

(002-006) 

04 

Jan 

127.22 

02 Jan-06 Jan 

43.0 

gamma-Velids 

(359-018) 

06 

Jan 

2.39 

25Dec-18Jan 

35.0 

alpha-Crucids 

(003-029) 

16 

Jan 

2.99 

03Jan-29Jan 

50.0 

alpha-Hydrusids 

(009-032) 

20 

Jan 

2.00 

09 Jan-OlFeb 

44.0 

alpha-Carinids 

(023-040) 

31 

Jan 

2.29 

23 Jan-09Feb 

25.0 

delta-Velids 

(028-048) 

07 

Feb 

1.29 

28Jan-17Feb 

35.0 

alpha-Centaurids 

(029-050) 

08 

Feb 

7.26 

29Jan-19Feb 

57.0 

omicron-Centaurids (035-052) 

12 

Feb 

2 .18 

04Feb-21Feb 

51.0 

theta-Centaurids 

(039-068) 

23 

Feb 

4.48 

08Feb-09Mar 

60.0 

delta-Leonids 

(034-075) 

24 

Feb 

1.10 

03Feb-16Mar 

23.0 

Virginids 

(049-070) 

29 

Feb 

1.50 

18Feb-llMar 

26.0 

gamma-Normids 

(063-079) 

13 

Mar 

5.76 

04Mar-20Mar 

56.0 

delta-Pavonids 

(079-114) 

31 

Mar 

5.28 

20Mar-24Apr 

60.0 

Lyrids 

(102-122) 

22 

Apr 

12 . 67 

12Apr-02May 

49.0 

mu-Virginids 

(120-151) 

30 

Apr 

2.20 

30Mar-31May 

30.0 

eta-Aquarids 

(093-160) 

06 

May 

36.66 

03Apr-09 Jun 

66.0 

alpha- Scorpi ids 

(124-148) 

16 

May 

3.18 

04May-28May 

35.0 

beta-Australids 

(122-150) 

16 

May 

3.00 

02May-30May 

45.0 

omega- Scorpi ids 

(141-165) 

02 

Jun 

5.18 

21May-14 Jun 

21.0 

day-Arietids 

(130-187) 

07 

Jun 

53.97 

lOMay-06 Jul 

38.0 

gamma- Sagi tar ids 

(132-210) 

20 

Jun 

2.40 

12May-29Jul 

29.0 

tau-Cetids 

(088-267) 

27 

Jun 

3.60 

29Mar-24Sep 

66.0 

tau-Aquarids 

(172-188) 

29 

Jun 

7 . 10 

21 Jun-07 Jul 

27.0 

theta-Ophiuchids 

(142-219) 

29 

Jun 

2.30 

22May-07Aug 

63.0 

v-Phoenicids 

(187-201) 

13 

Jul 

4 . 97 

06 Jul-20 Jul 

48.0 

o-Cygnids 

(188-211) 

19 

Jul 

2.49 

07 Jul-30Jul 

37.0 

Capricornids 

(171-240) 

25 

Jul 

2.20 

20Jun-28Aug 

25.0 

delta-Aquarids (N) 

(191-224) 

26 

Jul 

1.00 

10 Jul-12Aug 

42.0 

Pices -Austral ids 

(202-214) 

27 

Jul 

2.89 

21 Jul-02Aug 

42.0 

delta-Aquarids (S) 

(185-232) 

28 

Jul 

11.37 

04Jul-20Aug 

43.0 

iota-Aquarids (S) 

(198-233) 

03 

Aug 

1.50 

17 Jul-21Aug 

36.0 

Perseids 

(209-239) 

12 

Aug 

83.78 

28Jul-27Aug 

61.0 

kappa-Cygnids 

(210-251) 

19 

Aug 

2.29 

29Jul-08Sep 

27.0 

epsilon-Eridanids 

(219-255) 

25 

Aug 

39.81 

07Aug-12Sep 

59.0 

gamma- Dor adids 

(231-250) 

28 

Aug 

4.76 

19Aug-07Sep 

41.0 

Aurigids 

(232-253) 

31 

Aug 

8.93 

20Aug-10Sep 

69.0 

kappa-Aquarids 

(249-276) 

19 

Sep 

2.69 

06Sep-030ct 

19.0 

epsilon-Geminids 

(274-310) 

19 

Oct 

2.90 

010ct-06Nov 

71.0 

Orinids 

(274-314) 

21 

Oct 

24 . 98 

OlOct-lONov 

67.0 

Leo-Minorids 

(286-305) 

22 

Oct 

1.89 

130ct-01Nov 

61.0 

Taurids 

(236-016) 

05 

Nov 

7.29 

24Aug-16Jan 

30.0 

delta-Eridanids 

(305-324) 

11 

Nov 

0.90 

OIN0V-2ON0V 

31.0 

squiggle-Puppids 

(306-329) 

14 

Nov 

3.19 

02NOV-25NOV 

41.0 

Leonids 

(315-327) 

17 

Nov 

22.77 

11NOV-23NOV 

71 . 0 

Puppids 

(289-021) 

03 

Dec 

4.50 

160ct-21 Jan 

40.0 

Phoenicids 

(333-343) 

04 

Dec 

2.79 

29Nov-09Dec 

18.0 

Monocerotids 

(341-351) 

12 

Dec 

2.00 

07Dec-17Dec 

43.0 

Geminids 

(340-355) 

13 

Dec 

87.85 

06Dec-21Dec 

36.0 

sigma-Hydrusids 

(337-364) 

17 

Dec 

2.49 

03Dec-30Dec 

59.0 

Ursids 

(353-359) 

22 

Dec 

11.68 

19Dec-25Dec 

35.0 
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METEOR  IMPACT  MAP  Inputs 

The  METEOR  IMPACT  science  module  requires  the  following  inputs, 

Global  Parameters:  Year,  Day,  and  UT  (Kp,  SSN,  El 0.7  and  Ap  are  not  used). 

Meteor  shower  fluxes  can  be  determined  using  two  different  Count  Methods, 

Flux  Only:  Select  the  Flux  Only  option  to  specify  the  total  meteor  shower  hourly 

impact  rate  on  an  assumed  cross  sectional  area  of  1  square  meter.  Sporadic 
meteors  are  included  if  the  Sporadics  option  is  also  selected  (see  below). 

Damage:  Selecting  the  Damage  option  to  account  for  only  those  meteors  that  will 

intersect  a  user-defined  cross  sectional  area  and  damage  a  given  material 
type  by  exceeding  a  prescribed  pit  depth  threshold.  Sporadic  meteors  are 
included  if  the  Sporadics  option  is  also  selected  (see  below).  Selecting  the 
Damage  option  requires  the  following  additional  inputs. 

Cross  Section:  The  cross  section  of  the  material  of  interest  (m  ) 

Pit  Depth:  The  threshold  minimum  pit  depth  (mm)  causing  by  a 

meteor  impact. 

Material  Type:  Fixed  material  options  include  aluminum,  copper, 

stainless  steel,  beryllium/copper,  iron,  silver,  platinum, 
gold,  titanium.  Mylar,  and  glass. 

User  Def:  Select  this  option  to  set  the  user-defined 

-5 

material  characteristics  Density  (g/cm  )  and  Tensile 
strength  (MPa). 

Sporadics:  The  Sporadics  option  adds  sporadic  meteors  and  dust  to  the  Flux  Only  or 

Damage  calculations  above.  Sporadic  meteors  are  considered  to  be 
random  occurrences  and  not  associated  with  a  particular  meteor  shower. 
Note  that  the  sporadic  meteors  occur  year-round.  The  exclusion  of  the 
Sporadic  meteors  can  be  useful  when  studying  low  activity  periods  of  the 
annual  showers,  where  their  effects  could  be  masked  by  the  sporadics. 

The  Storm  Simulation  (Optional)  section  allows  user-defined  meteor  storms  to  be  added  to  the 
annual  meteor  showers  that  are  active  at  the  specified  date.  Meteor  storm  characteristics  are 
defined  in  terms  of  (1)  an  active  associated  shower,  (2)  the  peak  Zenithal  Hourly  Rate,  (3)  a 
storm  peak  time,  and  (4)  the  storm  duration.  Once  the  parameters  are  set  for  the  user-defined 
storm,  use  the  Add  button  to  place  the  storm  in  the  active  list  located  just  above  the  Add  and 
Delete  buttons.  Use  the  Delete  button  to  remove  storms  from  the  active  list.  A  maximum  of  five 
storms  may  be  specified.  The  meteor  storm  input  parameters  include  the  following: 

Shower  Name:  To  create  a  meteor  storm  associated  with  a  particular  shower,  use  the 

selector  button  to  browse  the  list  of  named  showers.  For  a  meteor  storm  to 
be  properly  applied,  the  run-time  Day  entered  at  the  globals  section  must 
fall  within  the  valid  day-of-year  range  noted  in  parentheses  next  to  the 
shower  name. 
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ZHR  Max: 


To  set  the  size  of  the  meteor  storm,  enter  the  Zenithal  Hourly  Rate 
maximum  in  the  ZHR  Max  text  box.  Note  that  as  a  guide,  the  Shower  Data 
button  contains  the  typical  ZHR@Peak  value  and  velocity  for  each 
shower. 

Two  methods  are  provided  for  specifying  meteor  storm  time  and  duration. 

Solar  Long/Duration  Delta:  If  the  Solar  Long/Duration  Delta  method  is  selected,  center  the 

meteor  storm  on  a  specific  time  by  entering  the  Solar  Longitude  value  in 
degrees  into  the  Solar  Long  text  box.  Set  the  length  of  the  storm  in  degrees 
using  the  Duration  Delta  (deg)  text  box.  Note  that  1-hour  is  equal  to 
~0.042  degrees  solar  longitude.  The  maximum  allowed  storm  duration  is 
0.5  degrees  (~12  hours).  Tables  of  solar  longitude  versus  day-of-year 
equivalents  can  be  found  at  the  International  Meteor  Organization  website 
(www.imo.net).  Zero  degrees  solar  longitude  generally  occurs  on  or  about 
20  March. 

Date/Duration:  If  the  Date/Duration  method  is  selected,  center  the  meteor  storm  on  a 

specific  time  by  using  the  Year,  Day,  Hour,  Minute  text  boxes  and  set  the 
length  of  the  storm  in  hours  using  the  Duration  (Hr)  text  box.  The 
maximum  allowed  storm  duration  is  12  hours. 

METEOR  IMPACT  MAP  Outputs 

The  METEOR  IMPACT  MAP  science  module  returns  a  3D  Gridded  Data  Set  representing  the 
hourly  impact  rate  (meteors/hour)  for  the  single  time  entered  in  the  Globals  section.  Using  the 
Flux  Only  mode,  the  hourly  impact  (on  a  cross  sectional  area  of  1  m  )  includes  meteors  from  all 
showers  active  at  the  run  time.  Using  the  Damage  mode,  the  hourly  impact  output  includes  only 
those  meteors  that  would  impact  the  user-defined  material  area  and  result  in  damage  to  at  least 
the  user-defined  pit  depth.  We  recommend  displaying  output  in  2D  or  3D  plots  using  the 
COORD-SEICE  graphical  object.  The  geometry  of  multiple  coincident  shows  can  be  viewed 
using  the  ISOCONTOUR  graphical  object. 

The  SATEL-APP  application  and  ORBIT  PROBE  graphics  modules  can  be  used  together  to 
view  hourly  meteor  impact  rates  along  an  orbit  path,  but  the  result  is  only  approximate  if  the 
science  module  is  run  in  static  mode.  While  a  dynamic  science  module  run  can  be  performed  and 
a  satellite  flown  though  stepped  outputs,  a  much  more  realistic  estimate  of  the  hourly  impact  of 
meteors  along  a  satellite  orbit  can  be  obtained  by  using  the  application  designed  specifically  for 
this  purpose,  namely  METEOR  IMPACT-APP. 
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The  METEOR  SKY  MAP  Science  Module 


Model  Name: 
Version: 
Developer: 
Referenees: 


Meteor  Ground-Based  Sky  Map  Model 
February  2004 

Radex,  Ine.  (now  AER,  Ine.)  and  the  Air  Force  Research  Laboratory 

Ceplecha,  Z.,  J.  Borovicka,  W.G.  Elford,  D.O.  Revelle,  R.L.  Hawkes,  V. 
Porubcan,  and  M.  Simek,  Meteor  Phenomena  and  Bodies,  Space  Sci.  Rev., 
84,  327-471  (1998) 

Foschini,  L.,  Meteoriod  Impacts  on  Spacecraft,  m  Meteors  in  the  Earth's 
Atmosphere,  edited  by  E.  Murad  and  I.P.  Williams,  Cambridge  University 
Press,  Cambridge,  UK,  249-263  (2002) 

Jenniskens,  P.,  Meteor  Stream  Activity:  I.  The  Annual  Streams, 
Astronomy  and  Astrophysics.,  287,  990-1013  (1994) 

Lai,  S.T.,  E.  Murad,  and  WJ.  McNeil,  Hazards  of  Hypervelocity  Impacts 
on  Spacecraft,  J.  of  Spacecraft  and  Rockets,  39,  1 06- 1 14  (2002) 

Love,  S.  G.,  and  D.  E.  Brownlee,  A  Direct  Measurement  of  the  Terrestrial 
Mass  Accretion  Rate  of  Cosmic  Dust,  Science,  262,  550-553  (1993) 

McBride,  N.,  The  Importance  of  the  Annual  Meteoroid  Streams  to 
Spacecraft  and  Their  Detectors,  Advanced  Space  Research,  20(8),  1513- 
1516(1997) 

McDonnell,  J.A.M.,  and  K.  Sullivan,  Hypervelocity  Impacts  on  Space 
Detectors:  Decoding  the  Projectile  Parameters,  Proceedings  of  the 
Workshop  on  Hypervelocity  Impacts  in  Space,  U.  of  Kent,  Canterbury, 
UK,  1-5  July  (1991) 

McKinley,  D.  W.  R.,  Meteor  Science  and  Engineering,  McGraw-Hill, 
New  York  (1961) 

McNeil,  W.  J.,  E.  Murad,  and  J.  M.  C.  Plane,  Models  of  Meteoric  Metals 
in  the  Atmosphere,  in  Meteors  in  the  Earth's  Atmosphere,  edited  by  E. 
Murad  and  I.P.  Williams,  Cambridge  University  Press,  Cambridge,  UK, 
265-287  (2002) 

Williams,  I.P.,  and  E.  Murad,  Introduction,  m  Meteors  in  the  Earth's 
Atmosphere,  edited  by  E.  Murad  and  I.P.  Williams,  Cambridge  University 
Press,  Cambridge,  UK,  1-11  (2002) 


Note:  It  is  recommended  that  AF-GEOSpace  users  read  and  understand  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 


METEOR  SKY  MAP  Overview 

The  METEOR  SKY  MAP  science  module  calculates  the  number  of  visible  meteors  from  the 
active  meteor  showers  (and  any  user-specified  storms)  at  the  specified  date,  over  a  grid  of 
ground-level  positions  covering  the  entire  globe.  An  unobstructed  field  of  view  of  the  sky  is 
assumed,  with  conditions  permitting  meteors  of  6.5  magnitude  or  brighter  to  be  observed. 
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Meteor  shower  intensities  are  expressed  in  a  zenith  hourly  rate,  or  ZHR  [see  Table  1  of  the 
previous  section  (The  METEOR  IMPACT  MAP  Science  Module)  or  access  the  Annual  Shower 
Table  button  in  the  Environment  Window].  These  values  are  estimates  of  the  number  of  visible 
meteors  per  hour  when  the  shower's  radiant  is  at  the  zenith  (directly  overhead)  of  the  observer's 
location,  and  under  optimal  viewing  conditions.  The  number  of  viewable  meteors  decreases 
considerably  due  to  atmospheric  effects  and  geometry  (i.e.,  the  horizon)  as  the  shower's  radiant 
and  observer  position  become  separated  by  a  larger  angular  extent.  The  apparent  brightness  of 
the  meteors  decreases  as  a  function  of  this  angular  distance,  causing  many  to  fall  below  the  6.5 
magnitude  brightness  viewing  threshold.  The  sporadic  meteors,  however,  are  treated  differently. 
While  no  true  shower  radiant  exists,  the  intensity  of  the  sporadic  meteors  is  modeled  to  vary  with 
both  local  time  and  geographic  latitude. 

METEOR  SKY  MAP  Reference  Data 

Reference  materials  describing  annual  meteor  shower  activity  can  be  accessed  using  the  set  of 
three  Database  buttons  at  the  top  of  the  METEOR  SKY  MAP  Environment  Window. 

Elux  Sums  The  Flux  Sums  button  displays  a  single  page  PDE  with  a  plot  of  "Annual 

Meteor  Shower  Elux  (#/meters  /s)"  for  a  typical  year.  Most  flux  peaks  are 
labeled  with  the  name  of  the  dominant  shower. 

ZHR  Sums  The  ZHR  Sums  button  displays  a  single  page  PDE  with  a  plot  of  "Zenithal 

Hourly  Rate  (ZHR)  Sum  of  Active  Showers"  and  a  plot  of  "Number  of 
Active  Showers"  for  a  typical  year.  Most  ZHR  sum  peaks  are  labeled  with 
the  name  of  the  dominant  shower. 

Annual  Shower  Table  The  Annual  Shower  Table  button  displays  a  text  dialog  with  a  list  of 
meteor  showers  with  basic  features,  i.e..  Shower  Name,  Julian  Day  of 
Year  (DOY)  Range,  Peak  Date,  Zenithal  Hourly  Rate  at  the  peak  date  (i.e., 
ZHR@Peak),  Calendar  Date  Range,  and  velocity  (km/s). 

METEOR  SKY  MAP  Inputs 

The  METEOR  SKY  MAP  science  module  requires  the  following  inputs. 

Global  Parameters:  Year,  Day,  and  UT  (Kp,  SSN,  El 0.7  and  Ap  are  not  used). 

Meteor  ground-based  sky  maps  can  be  produced  using  two  different  Count  Methods, 

Elux:  The  Flux  count  method  is  used  to  determine  meteoric  total  flux  (#/s/m  ) 

over  the  entire  Earth's  surface.  If  selected,  a  value  for  the  limiting  low-end 
Mass  (grams)  must  be  entered  in  the  text  box.  Note  that  the  output 
becomes  vanishingly  small  when  the  mass  reaches  approximately  10 
grams.  Sporadic  meteors  (see  description  below)  can  be  included  by 
checking  the  box  to  the  far  right. 

Visual:  The  Visual  count  method  is  used  to  determine  the  meteoric  observed 

Zethinal  Hourly  Rate  (ZHR)  from  ground  level.  If  selected,  a  value  for  the 
limiting  low-end  Magnitude  must  be  entered  in  the  text  box.  Note  that 
observed  brightness  of  a  meteor  decreases  as  its  visual  magnitude 
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increases.  Sporadic  meteors  (see  description  below)  can  be  included  by 
eheeking  the  box  to  the  far  right. 

Sporadics:  The  Sporadics  option  adds  sporadie  meteors  and  dust  to  the  Flux  or  Visual 

caleulations  above.  Sporadic  meteors  are  considered  to  be  random 
occurrences  and  not  associated  with  a  partieular  meteor  shower.  Note  that 
the  sporadie  meteors  occur  year-round.  The  exelusion  of  the  sporadic 
meteors  ean  be  useful  when  studying  low  activity  periods  of  the  annual 
showers,  where  their  effeets  could  be  masked  by  the  sporadics. 

The  Storm  Simulation  (Optional)  seetion  allows  user-defined  meteor  storms  to  be  added  to  the 
aimual  meteor  showers  that  are  active  at  the  specified  date.  Meteor  storm  eharacteristies  are 
defined  in  terms  of  (1)  an  active  associated  shower,  (2)  the  peak  Zenithal  Hourly  Rate,  (3)  a 
storm  peak  time,  and  (4)  the  storm  duration.  Once  the  parameters  are  set  for  the  user-defined 
storm,  use  the  Add  button  to  place  the  storm  in  the  active  list  located  just  above  the  Add  and 
Delete  buttons.  Use  the  Delete  button  to  remove  storms  from  the  active  list.  A  maximum  of  five 
storms  may  be  specified.  The  meteor  storm  input  parameters  include  the  following; 

Shower  Name:  To  ereate  a  meteor  storm  associated  with  a  partieular  shower,  use  the 

selector  button  to  browse  the  list  of  named  showers.  For  a  meteor  storm  to 
be  properly  applied,  the  run-time  Day  entered  at  the  Globals  section  must 
fall  within  the  valid  day-of-year  range  noted  in  parentheses  next  to  the 
shower  name. 

ZHR  Max:  To  set  the  size  of  the  meteor  storm,  enter  the  Zenithal  Hourly  Rate 

maximum  in  the  ZF[R  Max  text  box.  Note  that  as  a  guide,  the  Shower  Data 
button  contains  the  typical  ZHR@Peak  value  and  velocity  for  each 
shower. 

Two  methods  are  provided  for  specifying  meteor  storm  time  and  duration. 

Solar  Long/Duration  Delta;  If  the  Solar  Long/Duration  Delta  method  is  selected,  center  the 

meteor  storm  on  a  specific  time  by  entering  the  Solar  Longitude  value  in 
degrees  into  the  Solar  Long  text  box.  Set  the  length  of  the  storm  in  degrees 
using  the  Duration  Delta  (deg)  text  box.  Note  that  1-hour  is  equal  to 
~0.042  degrees  solar  longitude.  The  maximum  allowed  storm  duration  is 
0.5  degrees  (~12  hours).  Tables  of  solar  longitude  versus  day-of-year 
equivalents  can  be  found  at  the  International  Meteor  Organization  website 
(www.imo.net).  Zero  degrees  solar  longitude  generally  oeeurs  on  or  about 
20  March. 

Date/Duration;  If  the  Date/Duration  method  is  selected,  center  the  meteor  storm  on  a 

specifie  time  by  using  the  Year,  Day,  Flour,  Minute  text  boxes  and  set  the 
length  of  the  storm  in  hours  using  the  Duration  (Hr)  text  box.  The 
maximum  allowed  storm  duration  is  12  hours. 
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METEOR  SKY  MAP  Outputs 

The  METEOR  SKY  MAP  science  module  returns  a  2D  Gridded  Data  Set  at  the  Earth  surface.  If 
the  Flux  count  method  was  used  then  the  data  are  given  in  units  of  flux  (meteors/s/m  ).  If  the 
Visual  count  method  was  used  then  the  data  are  given  in  terms  of  a  Zenithal  Hourly  Rate  (ZHR). 
Display  output  in  2D  or  3D  plots  using  the  COORD-SLICE  graphics  object. 
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The  MSM  Science  Module  (V2.5.1  Only) 

Model  Name:  Magnetospherie  Speeification  Model  (MSM) 

Version:  5.20  (November  1996) 

Developer:  Riee  University  and  the  Air  Force  Research  Laboratory 

References:  Gussenhoven,  M.S.,  Hardy,  D.A.,  and  Heinemann,  N.,  Systematics  of  the 

Equatorward  Diffuse  Auroral  Boundary,  J.  Geophys.  Res.,  88,  5692-5708 
(1983) 

Hard,  M.,Wolf,  R.A.,  Reiff,  P.H.,  Spiro,  R.W.,  Burke,  W.J.,  Rich,  F.J.  and 
Smiddy,  M.,  Quantitative  Simulation  of  a  Magnetospherie  Substorm  1, 
Model  Logic  and  Overview,  J.  Geophys.  Res.,  86,  2217-2241  (1981) 

Heppner,  J.P.,  and  Maynard,  N.C.,  Empirical  High-Latitude  Electric  Field 
Models,/.  Geophys.  Res.,  92,  4467-4489  (1987) 

Hilmer,  R.V.  and  G.-H.  Voigt,  A  Magnetospherie  Magnetic  Field  Model 
with  Flexible  Current  Systems  Driven  by  Independent  Physical 
Parameters.  J.  Geophys.  Res.,  100,  5613-5626  (1995) 

Hilmer,  R.V.,  A  Magnetospherie  Neutral  Sheet-Oriented  Coordinate 
System  for  MSM  and  MSFM  Applications,  USAF  Phillips  Laboratory 
Technical  Report,  PL-TR-97-2133  (1997),  ADA  338067 

Hilmer,  R.V.,  and  Ginet,  G.P.,  A  Magnetospherie  Specification  Model 
Validation  Study:  Geosynchronous  Electrons,  J.  Atmos.  Solar-Terr.  Phys., 
62,  1275-1294  (2000) 

[see  $AFGS_HOME\models\REFS\HilmerGinet2000.pdf] 

Rich,  F.J.,  and  Maynard,  N.C.,  Consequences  of  Using  Simple  Analytic 
Functions  for  the  High-Latitude  Convection  Electric  Field.  J.  Geophys. 
Res.,  94,  3687-3701  (1989) 

Tascione,  T.,  Kroehl,  H.W.,  Creiger,  R.,  Freeman,  J.W.,  Wolf,  R.A.  Spiro, 
R.W.,  Hilmer,  R.V.,  Shade,  J.,  and  Hausman,  B.,  New  Ionospheric  and 
Magnetospherie  Specification  Models.  Radio  Sci.,  23,  211-222  (1988) 

Note:  It  is  recommended  that  AF-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

MSM  Overview 

The  Magnetospherie  Specification  Model  (MSM)  was  developed  by  Rice  University  for  the 
USAF  to  address  spacecraft  charging  issues  in  the  inner  and  middle  magnetosphere  [Tascione  et 
al,  1988].  It  combines  theoretical  and  empirical  approaches  to  make  maximal  use  of  real-time 

^  Freeman,  Jr.,  J.W.,  Wolf,  R.A.,  Spiro,  R.W.,  Voigt,  G.-H.,  Hausman,  B.A.,  Bales,  B.A., 

Hilmer,  R.V.,  Nagai,  A.,  and  Lambour,  R.,  Magnetospherie  Specification  Model  Development 
Code  and  Documentation.  Report  for  USAF  contract  F19628-90-K-0012,  Rice  University, 
Houston,  TX  (1993) 
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data  streams  so  it  can  respond  to  changing  geophysical  conditions  on  15-30  minute  time  scales. 
The  MSM  first  became  operational  in  1995.  The  following  is  from  Hilmer  and  Ginet  [2000]. 

“The  MSM  specifies  fluxes  (#/cm  /s/sr/keV)  of  charged  particles  having  energies  up  to 
100  keV  (electron,  H-H,  and  0+).  The  model  is  driven  by  any  combination  of  parameters 
with  the  minimum  input  requirement  being  Kp.  [. . .]  The  MSM  tracks  particles  in  a  two- 
dimensional  simulation  region  as  they  E  x  B  and  gradient-curvature  drift  through  dawn- 
dusk  symmetric  magnetic  field  configurations  with  the  (Earth  centered,  spin-aligned) 
dipole  tilt  angle  fixed  equal  to  zero,  i.e.,  aligned  with  the  GSM  z-axis.  The  inner  limit  of 
the  modeling  region  is  set  at  a  geocentric  distance  of  3  Re  (Earth  Radii).  The  outer 
boundary  extends  from  just  inside  the  dayside  magnetopause  to  roughly  twice  that 
geocentric  distance  on  the  nightside.  It  remains  inside  the  magnetopause  at  dawn  and 
dusk  local  times.  A  set  of  regularly  spaced  ionospheric  grid  points  is  magnetically 
mapped  to  the  simulation  plane  to  define  the  grid  where  the  particle  dynamics  are 
actually  tracked.  At  geosynchronous  altitude  (~6.6  Re)  the  resulting  grid  spacing  is 
typically  -0.2  to  1.0  Re  in  the  radial  direction  and  7.5°  in  longitude,  i.e.,  equivalent  to  30 
minutes  for  [a  geosynchronous]  spacecraft. 

The  magnetic  field  model  {Hilmer  and  Voigt,  1995)  uses  Dst  and  the  auroral  boundary 
index  (ABI)  defined  as  the  midnight  equatorward  boundary  of  the  diffuse  aurora  at  local 
midnight  {Gussenhoven  et  ah,  1983).  It  also  uses  the  magnetopause  standoff  distance  as 
estimated  from  solar  wind  density  and  velocity  measurements.  The  nightside  magnetic 
field,  especially  near  geosynchronous  altitudes,  becomes  more  distended  or  stretched  as 
the  ABI  moves  to  lower  latitudes.  With  magnetic  field  lines  assumed  to  be  lines  of 
constant  potential,  the  electric  potential  pattern  is  imposed  on  the  equatorial  simulation 
plane.  Inductive  electric  fields  affects  are  introduced  implicitly  through  ionosphere- 
equatorial  plane  magnetic  field  line  mapping  changes. 

The  electric  field  model  incorporates  a  version  of  the  Heppner-Maynard  empirical  model 
{Heppner  and  Maynard,  1987;  Rich  and  Maynard,  1989)  in  the  polar  cap  which  is 
extended  to  lower  latitudes  using  analytical  methods  based  on  more  self-consistent 
modeling  approaches  (e.g.,  Harel  et  ah,  1981).  It  uses  the  polar  cap  potential  drop,  polar 
cap  pattern  type  or  interplanetary  magnetic  field  (IME),  and  the  ABI.  The  ionospheric 
electric  field  strengthens  as  the  polar  cap  potential  increases  and  the  electric  potential 
pattern  enlarges  as  the  ABI  moves  to  lower  latitudes.  An  important  dynamic  feature  is 
that  the  penetration  of  electric  fields  to  sub-auroral  latitudes  is  dependent  on  the  rate  of 
change  of  the  ABI. 

The  initial  and  time-dependent  particle  boundary  conditions  are  controlled  by  Kp  but 
boundary  conditions  are  also  modified  according  to  the  polar  cap  potential  [...]. 

Minimum  and  maximum  particle  flux  levels  assigned  throughout  the  simulation  region 
are  enforced  such  that  model  output  will  fall  within  specified  limits.” 

MSM  Inputs 

The  MSM  science  module  runs  only  in  dynamic  mode  and  thus  requires  the  Global  Parameters 
Start:  Year,  Day,  UT  and  End:  Year,  Day,  and  UT.  While  the  minimum  run  interval  is  only  15 
minutes  (900  s),  in  practice  the  simulation  interval  should  be  set  to  include  the  interval  3-6  hours 
before  the  actual  period  of  interest  to  allow  the  initial  dawn-dusk  symmetric  boundary  conditions 
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to  dissipate.  Note  that  while  the  Global  inputs  Kp  and  SSN  are  used  (F10.7  and  Ap  are  not  used), 
the  MSM  seienee  module  obtains  those  input  values  from  an  arehived  data  set  separate  from  the 
standard  AF-GEOSpaee  global  inputs  (see  the  Archive  Input  Data  Files  seetion  below).  The 
MSM  Options  are  as  follows: 

Run  ID:  User-ereated  run  identifieation  (68  eharaeters  maximum).  This  deseriptive 

eharaeter  string  is  reeorded  in  file  _msmin.dat  (where  represents  the 
single  letter  Run  Prefix  deseribed  below)  ereated  in  the  MSM  folder  of  the 
seratch  spaee.  It  is  suggested  that  users  inelude  the  Global:  Start  and  End 
times  so  that  they  ean  be  reset  when  loading  saved  MSM  runs. 

Run  Type:  While  two  modes  of  MSM  runs  are  possible,  only  one  is  eurrently 

implemented  in  this  software  release. 

New  Run:  Indicates  that  a  new  MSM  run  is  requested. 

(Hot  Restart):  (not  yet  activated,  future  option  will  indicate  that  a 

previously  completed  MSM  run  will  be  continued  or 
extended  from  a  user-defined  point) 

Kp  Mode:  The  MSM  can  be  driven  with  different  combinations  of  input  parameters. 

Note  that  the  Kp  index  is  automatically  used  in  all  MSM  runs  and 
represents  the  default  input  set.  The  Kp  Mode  option  offers  three  different 
modes  of  running  the  MSM: 

Full  MSM  (Kp  to  fill  gaps):  This  mode  represents  the  most  general  way  to 
run  MSM  and  it  allows  the  user  to  select  from  the 
complete  set  of  available  input  parameters.  If  selected, 
an  MSM:  Use  Input  popup  window  will  appear  to 
register  global  parameter  input  preferences.  Each  data 
type  will  be  used  if  entries  exist  within  the  chosen 
dynamic  run  interval.  The  geomagnetic  index  Kp  is 
required  to  be  available  and  is  used  to  generate  proxies 
for  missing  input  data,  to  fill  data  gaps,  and  to  drive 
internal  parts  of  the  MSM  including  boundary 
conditions.  The  file  locations  of  the  Kp  values  and 
parameter  types  listed  here  are  given  below  in  the 
Archived  Input  Data  Files  section.  The  addition  input 
data  types  include: 

DST:  The  Dst  (disturbance  storm  time)  hourly  magnetic 
index  in  units  of  nT. 

EQ  Edge:  The  equatorward  edge  boundary  of  the 
diffuse  aurora  at  midnight  in  degrees  latitude  in  units  of 
degrees  latitude.  (Also  called  the  ABI  above  in  the 
literature  and  EqE  below  when  related  to  the  Show 
MSM  Inputs  feature). 
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PCP;  The  polar  cap  potential  input  represents  estimates 
of  the  total  potential  drop  across  the  polar  cap  measured 
in  kilovolts  by  the  DMSP  SSIES  drift  meter. 

SWDEN,  SWVEE:  These  options  represent  the  solar 
wind  density  (H+/cm  )  and  velocity  (m/s),  respectively. 
If  selected,  then  the  user  must  select  a  data  source 
{WIND  or  IMPS  spacecraft)  and  a  resolution  {Hourly 
Averages  or  Hi  Resolution  (90  sec)).  Note:  Owing  to 
space  limitation,  only  1996  data  provided  (see  below  to 
obtain  data  for  other  years)  and  no  Hi  Resolution  (90 
sec)  data  is  included  with  this  release  so  the  hourly 
values  will  always  be  used  if  the  SWDEN,  SWVEL 
option  is  selected. 

Einally,  the  ionospheric  electric  field  pattern  is 
determined  using  one  of  three  methods: 

IMEBY,  IMEBZ:  The  IME  By  and  Bz  components  in 
units  of  nT  (from  the  WIND  data  set)  are  used  to 
determine  the  value  oIXIPATT  (see  next  entry)  if  no 
DMSP  observations  of  the  polar  cap  pattern  are 
available.  Note:  Owing  to  space  limitation,  only  1996 
data  provided.  See  below  to  obtain  data  for  other  years. 

XIPATT:  The  DMSP-derived  potential  pattern  is  used. 
The  type  of  pattern  used  is  listed  after  a  run  under  the 
column  labeled  “P”  via  the  Show  MSM  Inputs  button. 
Pattern  P=0  is  for  IME-Bz  >  0.  Eor  IME-Bz  <  0,  the 
patterns  correspond  to  IME-By  <0  (P=l),  IME-By  =  0 
(P=2),  and  IMP-By>0  (P=3).  A  negative  sign  indicates 
that  the  observation  was  derived  from  a  DMSP  southern 
hemisphere  pass. 

No  IME,  XIPATT:  Select  if  no  specific  method  is 
desired.  A  default  symmetric  ionospheric  electric  field 
pattern  is  used. 

Kp  depend  empir.  flux  output:  This  option  skips  the  actual  particle  tracing 
portion  of  the  MSM  and  fills  the  output  files  with  Kp- 
dependent  empirical  flux  values.  Eluxes  are  distributed 
symmetrically  about  the  noon-midnight  plane  in  a 
manner  similar  to  those  used  for  the  initial  conditions. 

Kp  =>  proxies  for  all  input:  This  option  represents  the  “Kp-Only”  running 
mode  of  the  MSM.  The  Kp  index  is  the  only  required 
input  parameter  and  all  other  input  parameters  are 
replaced  by  proxy  values  derived  using  the  Kp-based 
relationships  described  by  Hilmer  and  Ginet  [2000]. 
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Run  Prefix: 


(Static  Inputs) 


Species: 


Energy  Range  (keV): 


L-Shell  Range: 


Run  Modes: 


A  single  character  selected  by  the  user  to  define  the  run.  This  character  is 
used  as  a  file  name  prefix  for  many  of  the  files  created  in  the  MSM  folder 
in  the  scratch  space. 

The  following  parameters  are  either  not  currently  activated  or  have  fixed 
values  for  this  implementation  of  the  MSM  program: 

Last  Record#:  (not  activated,  relates  to  future  Run  Type:  Hot  Restart) 

Start  Record#:  (not  activated,  relates  to  future  Run  Type:  Hot  Restart) 

Act  Start  Time:  (not  activated,  relates  to  future  Run  Type:  Hot  Restart) 

Min  Energy  (keV):  (Eixed)  Minimum  geosynchronous  energy  invariant  to 
be  tracked  by  the  MSM.  Eixed  equal  to  0.030  keV. 

Max  Energy  (keV):  (Eixed)  Maximum  geosynchronous  energy  invariant  to 
be  tracked  by  the  MSM.  Eixed  equal  to  200  keV. 

Energy  Spacing:  (Eixed)  Tracked  geosynchronous  invariant  energies  are 
spread  equally  by  the  fixed  value  of  0.50  in  loglO(eV), 
i.e.,  MSM  tracks  particles  of  10.,  31.63,  100.,  316.2, 
1000.,  3162.,  10000.,  31622.,  and  100000.  eV  (plus  a 
200000  eV  ending  value).  Tracked  values  are  selected 
from  this  set  to  span  the  Min  Energy  and  Max  Energy 
invariants. 

PCP  Eactor:  (Eixed)  Eactor  used  to  adjust  the  DMSP-derived  polar 

cap  potential  drop  value.  With  algorithm  improvements 
over  the  years,  the  current  value  is  fixed  equal  to  1.0. 

The  MSM  offers  the  option  to  track  electrons  (e-),  protons  (//+),  and 
oxygen  (0+).  Eor  each  species  selected,  the  model  tracks  a  set  of  particles 
at  set  invariant  energies  with  values  dependent  on  selections  made  from 
Energy  Range  and  L-Shell  Range  options  which  follow.  If  those  two 
options  are  not  changed  from  their  default  values,  then  MSM  will  track  10 
invariant  energies  for  each  species,  giving  a  total  of  30  species/energy 
pairs  that  the  model  can  follow. 

Low  and  High  particle  energies  defining  range  of  interest  (default  setting 
and  min/max  range  is  0.03  to  200  keV).  Along  with  the  L-Shell  Range 
inputs  below,  these  values  are  used  to  determine  which  invariant  energies 
will  be  traced  by  the  MSM. 

Low  and  High  L-shell  range  of  interest  (default  setting  and  min/max  range 
is  1.1  to  100  Re).  In  this  context,  the  L-shell  is  basically  the  geocentric 
radial  distance  in  the  equatorial  plane.  Along  with  the  Energy  Range 
inputs  above,  these  values  are  used  to  determine  which  invariant  energies 
will  be  traced  by  the  MSM. 

This  science  module  performs  two  basic  functions  which  can  be  run 
consecutively  or  separately  within  AE-GEOSpace.  The  first  function  is 
called  the  Base  run  and  represents  input  data  collection  and  processing 
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plus  the  actually  MSM  simulation  run  over  the  user-defined  dynamic 
interval.  The  second  function  maps  particle  fluxes  from  the  generic  MSM 
output  file  set  on  to  the  user-defined  grid  created  within  AF-GEOSpace 
using  the  Edit  menu  Grid  Tool  option.  The  mapping  procedure  uses  the 
MAP3D  and  FLUX3D  codes'^  and  the  magnetospheric  neutral  sheet- 
oriented  coordinate  system  of  Hilmer  [1997]. 

Base/Map:  Selecting  this  run  mode  will  run  the  MSM  simulation 

and  populate  the  user-defined  AF-GEOSpace  output 
grid  with  particle  fluxes  for  the  species/energy  pairs 
specified  using  the  Set  Map  Energies  button  (below). 

Base:  Selecting  this  run  mode  will  simply  run  the  MSM 

simulation.  In  order  to  visualize  the  model  output,  the 
user  must  subsequently  select  the  Map  mode  (below) 
and  again  use  the  Run/Update  option  of  the  Edit  menu. 

Map:  Selecting  this  run  mode  will  cause  the  software  to  look 

for  an  existing  set  of  MSM  run  files  corresponding  to 
the  Run  Prefix  entered.  If  the  files  are  located  in  the 
SciMsm  folder  being  used,  then  the  mapping  procedure 
is  applied  to  populate  the  user-defined  output  grid  with 
particle  fluxes  for  the  species/energy  pairs  specified 
using  the  Set  Map  Energies  button  (below).  This  option 
can  be  used  to  extract  fluxes  for  different  particle 
species/energies  from  an  existing  run  of  the  current 
session  or  by  loading  results  of  a  run  saved  during  a 
previous  session,  i.e.,  load  previously  saved  results  with 
the  Open  Model  option  of  the  File  menu,  select 
different  particle  energies  to  map,  and  use  the  Run 
Modes:  Map  option  so  that  the  Base  simulation  will  not 
be  unnecessarily  rerun. 

Note:  An  MSM  Base  run  does  not  need  to  be  done  if  the  user  simply  wants  to  map 
output  from  an  existing  run  using  either  a  modified  grid  or  a  different  set  of 
species/energy  pairs.  Simply  make  adjustments  to  the  grid  using  the  Grid  Tool 
option  of  the  Edit  menu  or  adjust  the  species/energy  pairs  using  the  Set  Map 
Energies  button,  then  set  Run  Modes  =  Map  and  use  the  Run/Update  option  of  the 
Edit  menu.  Remember  that  if  you  add  a  species/energy  pair  with  the  Set  Map 
Energies  button,  then  the  corresponding  entry  of  the  Dynamic  Tool  of  the  Edit 
menu  must  be  selected  so  that  the  new  quantity  will  be  written  to  file. 


^  Hilmer,  R.V.,  Wolf,  R.A.,  and  Hausman,  B.A.,  Mapping  Magnetospheric  Specification  Model 
Results  to  Arbitrary  Positions  in  the  3-D  Magnetosphere:  Development  of  FORTRAN 
Application  Codes  MAP3D  and  FFUX3D.  Final  Report  for  Hughes  STX  Corp.  subcontract  93- 
F04-H902,  Rice  University,  Houston,  TX  (1993) 
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Check  Modes:  The  Check  Modes  button  provides  a  popup  window  with  a  run  status 

summary  indicating  if  a  run  with  the  currently  selected  Run  Prefix  already 
exists  and  providing  a  list  of  the  available  valid  run  options. 

Show  MSM  Inputs:  After  an  MSM  run  is  complete,  selecting  this  button  produce  a  Show 
Inputs  popup  window  containing  the  derived  inputs  used  to  drive  the 
MSM  at  its  15 -minute  time  steps.  The  values  listed  were  derived  by 
interpolation  from  the  initial  input  parameter  data  sets.  These  derived 
numbers  are  from  the  file  _parameter  in  the  MSM  folder  in  the  scratch 
space.  In  order  to  produce  1 5 -minute  Kp  values  and  avoid  a  step-like 
change  in  the  parameters,  that  Kp  is  transitioned  gradually  each  3  hours. 
This  is  done  because  the  MSM  electric  field  model  uses  the  time-rate-of- 
change  of  Kp.  If  available,  the  values  for  Dst,  EqE,  PCP,  IMFBY,  IMFBZ, 
SWDEN,  and  SWVEL  are  all  determined  via  interpolation.  The 
magnetopause  standoff  distance  (Std)  is  derived  via  a  Kp  relationship  if 
SWDEN  and  SWVEL  are  not  available.  The  column  labeled  “P”  refers  to 
the  polar  cap  potential  pattern  type  XIPATT  described  above. 

Set  Map  Energies:  The  Set  Map  Energies  button  activates  the  MSM  Energies  popup  window 

used  set  the  particles  energies  to  be  processes  for  viewing  with  the 
graphics  modules.  The  user  may  enter  up  to  five  energies  (in  keV)  per 
active  species  where  active  species  are  those  checked  in  the  main  MSM 
environment  window,  i.e.,  e-,  H+,  and  0+.  By  default,  the  MSM  Energies 
window  is  set  such  that  only  30  keV  electrons  will  be  tracked.  For  a  given 
species/energy  pair  to  be  available  for  plotting,  the  corresponding  entries 
in  the  Dynamic  Tool  of  the  Edit  menu  must  be  selected  (see  next  note). 

Note:  To  visualize  all  user-designated  species/energy  pairs  selected  using  the  Set  Map 
Energies  button,  the  Dynamic  Tool  of  the  Edit  menu  for  an  active  MSM  science 
module  must  be  set  to  write  the  appropriate  quantities  to  file.  The  MSM  Dynamic 
Tool  window  entries  eEnergyO  to  eEnergyd  correspond  to  the  e-  Energy  (keV) 
entries  O-io-4  in  the  MSM  Energies  window.  Similarly,  the  Dynamic  Tool  entries 
hEnergyO  to  hEnergyd  correspond  to  the  H+  Energy  (keV)  entries  O-io-4  and  the 
entries  oEnergyO  to  oEnergy4  correspond  to  the  0+  Energy  (keV)  entries  O-io-4. 

In  addition,  if  the  GSM  X,  Y,  Z,  and  total  magnetic  field  values  {Bx,  By,  Bz,  and 
Btot)  from  the  MSM  are  to  be  plotted  then  they  must  also  be  selected  in  the 
Dynamic  Tool. 

Required  Library  Files 

The  mapping  procedure  used  to  fill  AF-GEOSpace  grids  with  MSM  output  is  from  Hilmer  et  al. 

[1993]  and  includes  updates  related  to  the  location  of  the  magnetotail  neutral  sheet  as  described 

by  Hilmer  [1997].  The  following  library  files  are  required  to  run  the  MSM  and  map  results 

(Note:  the  represents  a  variety  of  numeric  character  strings). 

$AFGS_HOME\models\data\MSM\BMATRIX  -  bo3*.dat  (1864  files,  350  MB) 

$AFGS_HOME\models\data\MSM\TBLMAT  -  TBL*.DAT,  MAT*. DAT {\S64  files,  1.16  GB) 
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$AFGS_HOME\models\data\MSM  -  static  fdes  COORD,  DKTABLE,  EFCOEF,  HARDY, 
lONENG,  and  lONNUM 

Archived  Input  Data  Files 

The  following  input  data  files  are  provided  for  running  the  MSM.  Input  data  used  to  drive  the 
MSM  are  arehived  in  a  separate  loeation  from  the  parameters  used  by  the  rest  of  the  software 
(i.e.,  the  Global  Parameters  deseribed  in  the  ENVIRONMENT  section  of  this  document).  Eor 
details  on  the  input  data  types  used  to  drive  the  MSM  and  a  deseription  of  proxy  values 
determined  using  the  Kp  index  please  see  seetion  5  of  Hilmer  and  Ginet  [2000].  Note  that 
additions  to  the  arehive  must  be  done  manually  as  no  automatie  updates  are  available.  Editing 
and  saving  data  values  via  the  Show  option  of  the  Globals  menu  does  not  change  the  inputs  used 
by  MSM.  In  the  following  deseriptions  the  characters  “TTTT”  indieate  the  calendar  year. 

$AEGS_HOME\models\data\MSM\P ARAMS  eontains  direetories: 

DST:  Hourly  Dst  index  from  files  dstYYYY  for  years  1957-2012  (May).  These  files 

mateh  those  supplied  via  $AEGS_HOME\models\data\GEOBAES\DST  and 
ean  be  updated  by  the  user  in  the  same  manner.  Souree:  NGDC  at  website 
ftp://ftp.ngde.noaa.gov/STP/GEOMAGNETIC_DATA/INDICES/DST/.  See 
the  file  OOinfo  DST  for  format  details. 

KP  AP:  Three-hour  Kp  index  and  SumKp  value  from  files  kpYYYY  for  years  1932- 

2012  (April).  These  files  match  those  in 

$AEGS_HOME\models\data\GEOBALS\KP  and  ean  be  updated  by  the  user 
in  the  same  manner.  Souree:  NGDC  at  website 

ftp://ftp.ngde.noaa.gov/STP/GEOMAGNETIC_DATA/INDICES/KP_AP/. 
See  the  file  OOinfo  KP  AP  for  format  details. 

$APGS_HOME\models\data\MSM\SPACECRAFT\DMSP  contains  directories: 

SSJ4\MEB:  Midnight  equatorward  boundary  values  (for  Eq.  Edge)  for  1983  to  day  104  of 

2010  from  files  mnitYYYY.new.  Source:  AFRL  (Dan  Madden  and  F.  J.  Rieh). 
See  the  file  00info_MEB  for  details. 

SSIESVPCSHRT:  Cross-polar  eap  potential  (for  PGP)  and  eleetrie  field  pattern  type  (for 

XIPATT)  for  years  1987-2004  from  DMSP  data  files  sDDYYYY.txt  where  DD 
is  the  DMSP  satellite  number  08,  10,  11,12,  or  13.  See  the  file 
OOinfo  PCSHRT  for  details. 

$AFGS_HOME\models\data\MSM\SPACECRAFT  eontains  direetories: 

IMP8:  Hourly  solar  wind  veloeity  (for  SWVEL),  density  (SWDEN),  temperature  from 

file  imp8. 1 996.hravg.subset.  Files  for  other  years  ean  be  obtained  from  the 
MIT  website  ftp://space.mit.edu/pub/plasma/imp/hr_avg/.  See  the  file 
00info_IMP8  for  format  details.  [Aeknowledgements:  A.J.  Eazarus,  P.A. 
Milligan,  and  K.I.  Paularena  (all  of  MIT)] 

WIND:  Hourly  IMF  (for  IMFBY,  IMFBZ)  from  files  1996_wnd_mfi.asc  and  solar 

wind  veloeity  and  density  from  files  1996_WIND_hourly_averages.  See  the 
file  00info_WIND  for  format  details.  Files  for  other  years  ean  be  obtained 
from  the  MIT  website  ftp://spaee.mit.edu/pub/plasma/wind/kp_fdes_hr_aves/. 
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[Acknowledgements:  Prineipal  Investigator  K.W.  Ogilvie  (NASA  GSFC), 

AJ.  Lazarus  (MIT)  and  J.C.  Kasper  (MIT)] 

Before  eaeh  MSM  run,  input  data  falling  within  the  simulation  interval  are  time  sorted  and 
rewritten  to  ereate  the  aetual  MSM  input  data  files  (i.e.,  DST,  EQEDGE,  EKP,  IMFBY,  IMFBZ, 
PCP,  SWDEN,  SWVEE,  SUMKP,  and XIPATT)  that  are  reeorded  in  the  SciMsm  direetory  in  the 
user’s  serateh  spaee.  The  Show  MSM  Inputs  button  ean  be  used  to  view  the  parameters  finally 
used  to  drive  the  MSM  at  15 -minute  time  steps. 

Notes  on  the  MSM  Run  Procedure 

For  a  detailed  deseription  of  an  MSM  simulation  using  this  module,  please  see  “Magnetospherie 
Speeifieation  Model”  in  the  EXAMPLES  seetion  of  this  doeument. 

Quiek-Start  Proeedure:  The  default  MSM  module  run  setup  will  produee  output  for  30  keV 
eleetrons  using  the  Kp  Mode  option  Kp=>proxies  for  all  input  (also  known  as  the  “Kp-Only” 
mode).  To  run  in  this  simplest  of  modes,  the  user  must  (1)  open  an  AE-GEOSpaee  session,  (2) 
establish  a  dynamie  run  by  plaeing  a  eheek  mark  in  the  box  to  the  right  of  the  Start:  UT  text  field 
and  eompleting  the  Start  and  End  time  fields,  and  (3)  use  the  Run/Update  option  of  the  Edit 
menu.  The  software  will  read  Kp  indiees  from  the  arehived  data  direetories  deseribed  above,  run 
the  MSM  simulation,  and  fill  the  grid  (see  the  Grid  Tool  option  of  the  Edit  menu)  with  30  keV 
eleetron  flux  values. 

Note:  If  no  environment  data  is  available  (not  even  Kp)  then  a  popup  message  will  appear 
indieating  "ERROR:  NTLINE=0,  global.dat  file  empty".  In  the  SciMsm  folder  created  at  run 
time,  see  the  file  global. inf  for  a  summary  of  data  sourees,  quantities  available,  and  names  of 
other  files  with  more  details.  The  file  dbg.txt  shows  what  the  session  looks  like  running  in 
EORTRAN  and  the  eontents  of  newly  ereated  files  ENCHAN  and  _msmin.dat  are  repeated  there. 

MSM  Outputs 

The  MSM  seienee  module  returns  a  3D  Gridded  Data  set  of  the  following  magnetospherie 
quantities:  eleetron  (e-),  proton  (H-H),  and  oxygen  (0+)  partiele  fluxes  in  units  of  Eog[#/em2-s- 
keV-ster],  and  magnetie  field  values  for  GSM  eomponents  Bx,  By,  Bz,  and  |B|  in  units  of  nT. 
Note  that  partieles  of  a  given  speeies/energy  will  be  found  in  a  limited  region  of  the 
magnetosphere  and  that,  in  general,  the  more  energetie  partieles  will  be  found  eloser  to  Earth. 
Otherwise,  if  no  partiele  flux  information  is  given  at  a  speeifie  grid  loeation  for  an  energy  set 
using  the  Set  Map  Energies  button,  then  either  (a)  the  grid  point  is  outside  of  the  MSM 
simulation  region,  or  (b)  that  partiele  energy  was  not  eovered  by  the  geosynehronous  invariant 
energy  ehannels  ealeulated  with  the  user-seleeted  Species:  Energy  Range  (keV)  and  L-Shell 
Range  values. 
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The  NASAELE  Science  Module 


NASA  Trapped  Electron  Model  AE-8 

National  Space  Science  Data  Center  (NSSDC)  Data  Set  PT-1  IB,  Oct 
1987;  IGRE  updates  2009 

NASA/NSSDC  (distributed  in  AE-GEOSpace  with  permission);  IGRE 
option  updates  by  AER,  Inc. 

Vette,  J.I.,  The  AE-8  Trapped  Electron  Model  Environment, 
NSSDC/WDC-A-RS  91-24  (1991) 

Vette,  J.I.,  The  NASA/National  Space  Science  Data  Center  Trapped 
Radiation  Environment  Model  Program  (1964-1991),  NSSDC/WDC-A-RS 
97-29(1991) 

Jordan,  C.E.,  NASA  Radiation  Belt  Models  AP-8  and  AE-8,  GL-TR-89- 
0267,  Geophysics  Eaboratory,  Hanscom  AEB,  MA  (1989),  ADA  223660 

Note:  It  is  recommended  that  AE-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

NASAELE  Overview 

The  NASAEEE  science  module  computes  the  differential  omni-directional  electron  flux  using 
the  NASA  AE-8  radiation  belt  models  for  ten  energy  intervals  between  0.5  and  6.6  MeV  which 
correspond  to  the  ranges  of  the  CURES  HEEE  instrument  data  channels  used  in  the  construction 
of  the  CRRESEEE  science  module.  Two  additional  channels  are  computed  that  represent  the 
energy  ranges  0.04-0.5  MeV  and  6.6-7  MeV  covered  in  the  NASA  models  but  not  covered  by 
the  HEEE  instrument.  The  following  NASA  radiation  belt  models  description  is  excerpted  from 
the  on-line  summary  and  instructions  available  at  the  anonymous  ftp  site 
NSSDCA.GSEC.NASA.GOV: 

“[The  NASA  radiation  belt]  models  describe  the  differential  or  integral,  omni-directional 
fluxes  of  electrons  (AE-8)  and  protons  (AP-8)  in  the  inner  and  outer  radiation  belts 
(electrons:  E=l.l  to  11,  protons:  E=  1.1  to  7)  for  two  epochs  representing  solar  maximum 
(1970)  and  minimum  (1964)  conditions.  The  energy  spectrum  ranges  from  0.1  to  400 
MeV  for  the  protons  and  from  0.04  to  7  MeV  for  the  electrons.  AE-8  and  AP-8  are  the 
most  recent  ones  in  a  series  of  models  established  by  J.  Vette  and  his  colleges  at  NSSDC 
starting  in  the  early  sixties.  The  models  are  based  on  almost  all  available  satellite  data”. 

The  NASAEEE  science  module  is  used  to  map  the  NASA  AE-8  electron  flux  models  for  either 
solar  maximum  (AE8MAX)  or  minimum  (AE8MIN)  conditions  onto  a  three-dimensional  spatial 
grid  specified  by  the  user.  A  variety  of  magnetic  field  models  can  be  used  for  the  mapping. 

NASAELE  Inputs 

The  NASAELE  science  module  requires  the  user  to  specify  the  following  information  to 
determine  which  data  set  to  use  and  which  magnetic  field  model  to  use  in  mapping  the  data. 

Energy  Channel(MeV):  The  energy  channel  parameter  specifies  which  of  10  electron  flux 

models,  corresponding  to  the  10  HEEE  instrument  energy  channels  used  in 
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the  CRRESELE  models,  is  to  be  used.  The  channels  used  for  the 
CRRESELE  models  are  to  be  eonsidered.  The  ehannels  span  the  range 
from  0.5-6. 6  MeV.  Two  additional  ehannels  are  ineluded  spanning  the 
ranges  above  (6. 6-7.0  MeV)  and  below  (0.04-0.5  MeV)  the  HEEF 
ehannels  eovered  by  the  NASA  models. 

The  magnetie  field  model  used  to  eonvert  from  the  B-L  eoordinates  of  the 
model  to  three-dimensional  spaee.  Originally  and  as  presented  in  AF- 
GEOSpaee  Version  2.1,  the  default  magnetie  field  was  the  model  used  to 
reduee  the  CURES  data,  i.e.,  IGRF85/0-P.  However,  after  ineluding  time- 
dependent  IGRF  internal  field  eapabilities  eovering  1945-2010,  the  current 
B-Model  options  inelude: 


Dipole: 

Dipole-Tilt: 

Dip-Tilt-Off: 

IGRF: 

IGRF/O-P: 


A  dipole  field 
A  tilted  dipole  field 
A  tilted-offset  dipole  field 

The  International  Geomagnetie  Referenee  Field  with  no 
external  contributions  (Extrapolation  beyond  2010). 

The  IGRF  internal  field  with  the  Olson  and  Pfitzer 
(1977)  statie  model  to  represent  the  external  field. 


The  aetivity  parameter  speeifies  whether  the  AE8MAX  (representative  of 
solar  maximum  eonditions)  or  the  AE8MIN  (representative  of  solar 
minimum  eonditions)  eleetron  flux  models  are  to  be  used. 


NASAELE  Outputs 

The  NASAELE  science  module  returns  a  3D  Gridded  Data  Set  of  the  eleetron  flux  for  the 
seleeted  energy  ehannel  and  aetivity  level  in  units  of  #/(om^  s  keV). 
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The  NASAPRO  Science  Module 

NASA  Trapped  Proton  Model  AP-8 

National  Spaee  Seience  Data  Center  (NSSDC)  Data  Set  PT-1  IB,  Oct 
1987;  IGRF  updates  2009 

NASA/NSSDC  (distributed  in  AF-GEOSpace  with  permission);  IGRF 
option  updates  by  AER,  Inc. 

Vette,  J.I.,  The  AE-8  Trapped  Electron  Model  Environment, 
NSSDC/WDC-A-RS  91-24  (1991) 

Vette,  J.I.,  The  NASA/National  Space  Science  Data  Center  Trapped 
Radiation  Environment  Model  Program  (1964-1991),  NSSDC/WDC-A-RS 
97-29(1991) 

Jordan,  C.E.,  NASA  Radiation  Belt  Models  AP-8  and  AE-8,  GL-TR-89- 
0267,  Geophysics  Eaboratory,  Hanscom  AEB,  MA  (1989),  ADA  223660 

Note:  It  is  recommended  that  AE-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

NASAPRO  Overview 

The  NASAPRO  science  module  computes  the  differential  omni-directional  proton  flux  using  the 
NASA  AP-8  radiation  belt  models  for  twenty-two  energy  intervals  between  1  and  100  MeV 
which  correspond  to  the  ranges  of  the  CRRES  PROTEE  instrument  channels  used  in  the 
construction  of  the  CRRESPRO  science  module.  [Note  that  Version  2.1  computed  two  additional 
channels  that  represented  the  energy  ranges  0.1 -1.0  MeV  and  100-400  MeV  covered  in  the 
NASA  models  but  not  covered  by  the  PROTEE  instrument.]  The  following  NASA  radiation  belt 
models  description  is  excerpted  from  the  on-line  summary  and  instructions  available  at  the 
anonymous  ftp  site  NSSDCA.GSEC.NASA.GOV: 

“[The  NASA  radiation  belt]  models  describe  the  differential  or  integral,  omni-directional 
fluxes  of  electrons  (AE-8)  and  protons  (AP-8)  in  the  inner  and  outer  radiation  belts 
(electrons:  E=l.l  to  1 1,  protons:  E=l.l  to  7)  for  two  epochs  representing  solar  maximum 
(1970)  and  minimum  (1964)  conditions.  The  energy  spectrum  ranges  from  0.1  to  400 
MeV  for  the  protons  and  from  0.04  to  7  MeV  for  the  electrons.  AE-8  and  AP-8  are  the 
most  recent  ones  in  a  series  of  models  established  by  J.  Vette  and  his  colleges  at  NSSDC 
starting  in  the  early  sixties.  The  models  are  based  on  almost  all  available  satellite  data”. 

The  NASAPRO  science  module  is  used  to  map  the  NASA  AP-8  proton  flux  models  for  either 
solar  maximum  (AP8MAX)  or  minimum  (AP8MIN)  conditions  onto  a  three-dimensional  spatial 
grid  specified  by  the  user.  A  variety  of  magnetic  field  models  can  be  used  for  the  mapping. 

NASAPRO  Inputs 

The  NASAPRO  science  module  requires  the  user  to  specify  the  following  information  to 
determine  which  data  set  to  use  and  which  magnetic  field  model  to  use  in  mapping  the  data. 

Energy  Channel(MeV):  The  energy  channel  parameter  selects  which  of  22  proton  flux  models, 

corresponding  to  the  22  PROTEE  instrument  energy  channels  used  in  the 
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construction  of  the  CRRESPRO  models,  is  to  be  used.  The  channels  range 
from  1.5  to  81.3  MeV.  Two  additional  ehannels  are  ineluded  spanning  the 
ranges  above  (100  to  400  MeV)  and  below  (0.1  to  1.0  MeV)  the  PROTEL 
ehannels  eovered  by  the  NASA  models. 

The  magnetic  field  model  used  to  eonvert  from  the  B-E  coordinates  of  the 
model  to  three-dimensional  spaee.  Originally  and  as  presented  in  AF- 
GEOSpaee  Version  2.1,  the  default  magnetie  field  was  the  model  used  to 
reduee  the  CURES  data,  i.e.,  IGRF85/0-P.  However,  after  ineluding  time- 
dependent  IGRF  internal  field  eapabilities  eovering  1945-2010,  the  eurrent 
B-Model  options  include: 


Dipole: 

Dipole-Tilt: 

Dip-Tilt-Off: 

IGRF: 

IGRF/O-P: 


A  dipole  field 
A  tilted  dipole  field 
A  tilted-offset  dipole  field 

The  International  Geomagnetie  Referenee  Field  with  no 
external  eontributions  (Extrapolation  beyond  2010). 

The  IGRF  internal  field  with  the  Olson  and  Pfitzer 
(1977)  statie  model  to  represent  the  external  field. 


The  aetivity  parameter  speeifies  whether  the  AP8MAX  (representative  of 
solar  maximum  eonditions)  or  the  AP8MIN  (representative  of  solar 
minimum  eonditions)  proton  flux  models  are  to  be  used. 


NASAPRO  Outputs 

The  NASAPRO  scienee  module  returns  a  3D  Gridded  Data  Set  of  the  proton  flux  for  the  seleeted 
energy  ehannel  and  aetivity  level  in  units  of  #/(om^  s  MeV). 
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The  NRLMSISE-00  Science  Module 


Model  Name:  NRLMSISE-00  Model  200 1 

Version:  Offieial  release  file  NRLMSISE-00.DIST17.TXT  obtained  from 

http://uap-www.nrl.navy.miEmodels_web/msis/msis_home.litm. 

Developer:  J.  M.  Pieone,  A.E.  Hedin,  and  D.P.  Drob,  Navel  Researeh  laboratory 

References:  Hedin,  A.E.,  MSIS-86  Thermospheric  Model,  J.  Geophys.  Res.  92,  4649 

(1987) 

Hedin,  A.E.,  Extension  of  the  MSIS  Thermospheric  Model  into  the  Middle 
and  Eower  Atmosphere,  J.  Geophys.  Res.,  96,  1 159  (1991) 

Jacchia,  E.,  New  Static  Models  of  the  Thermosphere  and  Exosphere  with 
Empirical  Temperature  Profiles,  Spec.  Rep.,  313,  Smithson!.  Astrophys. 
Observ.,  Cambridge,  Mass.,  May  6  (1970) 

Eabitzke,  K.,  J.J.  Barnett,  and  B.  Edwards  (eds.).  Handbook  MAP  16, 
SCOSTEP,  University  of  Illinois,  Urbana  (1985) 

Pieone,  J.M.,  A.E.  Hedin,  D.P  Drob,  and  A.C.  Aikin,  NRLMSISE-00 
Empirical  Model  of  the  Atmosphere:  Statistical  Comparisons  and 
Scientific  Issues,/.  Geophys.  Res.,  767(AI2),  1468, 
doi:I0.I029/2002JA009430  (2002) 

Note:  It  is  recommended  that  AE-GEOSpace  users  read  and  understand  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

NRLMSISE-00  Overview 

The  NRLMSISE-00  model  provides  a  description  of  the  atmosphere  as  a  function  of  location, 
time,  solar  activity  (E10.7),  and  geomagnetic  activity  (Ap).  NRLMSISE-00  models  altitude 
profiles  of  temperature  T(z),  the  number  density  of  various  species  (i.e..  He,  O,  N2,  O2,  Ar,  H, 
and  N)  that  are  in  equilibrium  with  temperature  T(z),  the  total  mass  density,  and  the  number 
density  of  a  high- altitude  “anomalous  oxygen”  component  not  in  equilibrium  at  T(z)  [Pieone  et 
al,  2002].  These  authors  also  note  that  the  NRLMSISE-00  empirical  atmospheric  model  is  a 
major  upgrade  of  the  MSISE-90  thermosphere  model  of  Hedin  [1991]  and  for  estimating  total 
mass  density,  it  is  comparable  to  or  better  than  the  Jacchia-class  models  (e.g.,  see  Jacchia 
[1970]).  Below  72.5  km,  the  MSISE-90  model  is  primarily  based  in  the  Labitzke  et  al.  [1985] 
tabulation  of  zonal  average  temperature  and  pressure.  Above  72.5  km,  MSISE-90  is  basically  a 
revised  MSIS-86  model  [Hedin,  1987].  Note  that  for  user  only  interested  in  the  thermosphere 
(above  120  km),  the  authors  recommend  the  MSIS-86  model.  As  noted  on  the  NSSDC  website 
referenced  above,  the  upgrade  from  MSISE-90  to  NRLMSISE-00  involves  (1)  extensive  use  of 
drag  and  accelerometer  data  on  total  mass  density,  (2)  the  addition  of  contributions  from  0+  and 
hot  oxygen  at  altitudes  above  500  km,  and  (3)  the  inclusion  of  Solar  Maximum  Mission  UV 
occultation  data  on  O2  number  density.  The  code  is  also  made  available,  along  with  many  other 
related  links,  by  NSSDC  at  (http://nssdc.gsfc.nasa.g0v/space/model/atmos/nrlmsiseOO.html). 
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NRLMSISE-00  Inputs 

The  NRLMSISE-00  science  module  requires  the  following  inputs, 

Global  Parameters:  Day,  UT,  F10.7,  and  Ap  (Year,  Kp,  and  SSN  are  not  used). 

10.7  cm  Radio  Flux  for  the  previous  day:  Daily  average  solar  radio  flux  at  10.7  cm  for  the 
previous  day  {FIO.  7P)  can  be  determined  two  ways. 

From  Globals:  The  program  assigns  FIO.  7P  a  value  equal  to  FIO. 7  for 

the  previous  day  as  noted  in  the  global  parameter  files. 

Set:  If  selected,  the  program  uses  the  value  entered  in  the 

newly  activated  text  window  FIO.  7P. 

81 -day  Average  (+/-  40  days)  10.7  cm  Radio  Flux:  This  input  is  the  81 -day  average  (including 
+/-  40  days  from  day  of  interest)  of  FIO. 7  daily  values  {FIO.  7A)  and  can 
be  determined  two  ways. 

From  Globals:  The  program  assigns  FIO.  7A  a  value  equal  to  the 

average  determined  using  the  global  parameter  files.  As 
noted  above,  the  last  valid  run  day  is  the  day  before  the 
last  day  listed  in  the  Kp  data  files  (which  contain  daily 
FIO. 7  values).  If  a  valid  day  is  selected,  then  the 
average  is  constructed  using  the  previous  40  days  plus 
any  available  forward  data,  with  the  last  good  day 
repeated  to  fill  out  the  required  forward  40-day  span. 

Set:  If  selected,  the  program  uses  the  value  entered  in  the 

newly  activated  text  window  FIO.  7A. 

Notes:  (1)  The  next  day’s  FIO. 7  value  is  needed  for  a  successful  run  (see  FIO.  7A  description 
above),  thus  the  last  valid  day  to  run  the  model  is  the  day  before  the  last  day  listed  in 
the  Kp  data  files  (see  directory  $AFGS_HOME\models\data\GFOBALS\KP). 

(2)  While  the  model  uses  the  global  parameter  FI 0.7,  it  does  not  use  the  single  value 
appearing  at  the  top  of  the  environment  window. 

(3)  As  noted  in  the  Model  Status  box  after  a  run,  this  installation  of  the  model 
substitutes  the  3-hour  Ap  index  value  for  the  Daily  Ap  index  it  expects  as  input,  i.e., 
the  user  can  specify  the  Daily  Ap  value  used  by  the  model  by  editing  the  Ap  text  box 
at  the  top  of  the  environment  window. 

(4)  For  dynamic  runs,  the  values  of  FIO.  7P  and  FIO.  7 A  determined  for  the  start  day 
will  be  used  unchanged  for  the  entire  run  interval. 

NRLMSISE-00  Outputs 

The  NRLMSISE-00  science  module  returns  a  3D  Gridded  Data  Set  of  the  following  quantities: 

■j 

HE  Number  Density:  Helium  (He)  number  density  (cm'  ). 

-5 

O  Number  Density:  Atomic  oxygen  (O)  number  density  (cm'  ).  Set  to  zero  below  72.5  km. 

N2  Number  Density:  Molecular  nitrogen  (N2)  number  density  (cm'  ). 

Ill 
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02  Number  Density: 
AR  Number  Density: 
Total  Mass  Density: 
H  Number  Density: 
N  Number  Density: 
anO  Num.  Density: 


T  Exospheric: 
T  at  Alt: 


Molecular  oxygen  (O2)  number  density  (cm'  ). 

Argon  (Ar)  number  density  (cm'  ). 

Total  mass  density  (g/cm  ). 

Atomic  hydrogen  (H)  number  density  (cm'  ).  Set  to  zero  below  72.5  km. 

-5 

Atomic  nitrogen  number  density  (cm'  ).  Set  to  zero  below  72.5  km. 

Anomalous  oxygen  number  density  (cm'  ).  Anomalous  oxygen  refers  to 
hot  atomic  oxygen  (Oh)  or  atomic  oxygen  ions  (O^)  present  at  high 
altitudes  (>  500  km)  that  are  not  in  thermal  equilibrium. 

Exospheric  temperature  (Degrees  K). 

Temperature  (Degrees  K). 


Eor  ID  vertical  profile  displays,  we  recommend  increasing  the  default  number  of  radial  points 
calculated  (using  the  Grid  Tool  option  of  the  Edit  menu)  and  displaying  a  COORD-PROBE 
graphical  object  in  a  ID  Viewport.  Eor  2D  or  3D  displays,  use  the  COORD-SEICE  graphical 
object.  To  examine  output  along  an  orbit  run  the  SATEE-APP  application  followed  by  the 
ORBIT-PROBE  graphical  object. 


112 

Approved  for  public  release;  Distribution  is  unlimited. 
AF-GEOSpace  User’s  Manual:  Version  2.5.1 


The  PIM  Science  Module 


Model  Name:  Parameterized  Ionospheric  Model  (PIM) 

Version:  1.7  (16  December  1999) 

Developer:  Computational  Physics,  Inc.  and  Air  Force  Research  Laboratory 

References:  Daniell,  R.E.,  Jr.,  L.D.  Brown,  D.N.  Anderson,  M.W.  Fox,  P.H.  Doherty, 

D.T.  Decker,  J.J.  Sojka,  and  R.W.  Schunk,  Parameterized  Ionospheric 
Model:  A  Global  Ionospheric  Parameterization  Based  on  First  Principles 
Models,  RaJzo  30,  1499-1510(1995) 

Strickland,  D.J.,  J.  E.  Bishop,  J.  S.  Evans,  T.  Majeed,  P.  M.  Shen,  R.  J. 
Cox,  R.  Eink,  and  R.  E.  Huffman,  Atmospheric  ultraviolet  radiance 
integrated  code  (PIM):  theory,  software  architecture,  inputs,  and  selected 
results,  J.  Quant.  Sped.  Rad.  Transfer,  62,  689  (1999) 

Computational  Physics,  Inc.,  PIM  1.7  User  Guide,  I3-January-I998 
(see  $APGS_HOME\models\REPS\pimI 7ug.pdf) 

Note:  It  is  recommended  that  AE-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

PIM  Overview 

The  PIM  science  module  is  a  relatively  fast  global  ionospheric  model  based  on  the  combined 
output  of  several  physical  ionospheric  models.  The  following  description  of  PIM  is  excerpted 
from  Daniell  et  al.  (1995), 

“[The  Parameterized  Ionosphere  Model  (PIM)]  is  a  global  model  of  theoretical 
ionospheric  climatology  based  on  diumally  reproducible  runs  of  four  physics-based 
numerical  models  of  the  ionosphere.  The  four  models,  taken  together,  cover  the  E  and  E 
layers  for  all  latitudes,  longitudes,  and  local  times.  PIM  consists  of  a  semi-analytic 
representation  of  diumally  reproducible  mns  of  these  models  for  low,  moderate,  and  high 
levels  of  solar  and  geophysical  activity  and  for  June  and  December  solstices  and  March 
equinox  conditions.” 

Prom  a  user-specified  set  of  geophysical  parameters,  including  year,  day,  UT,  solar  activity 
index  P10.7,  sunspot  number,  geomagnetic  activity  index  Kp,  and  the  directions  of  the 
interplanetary  field  components  By  and  Bz,  the  PIM  science  module  computes  values  of  the 
electron  density  on  a  user-specified  3D  grid.  The  range  in  altitude  is  90  to  1600  km.  Also 
computed  by  PIM  and  output  on  2D  grids  are  the  height-independent  critical  frequencies  and 
heights  for  the  ionospheric  E-  and  P2-regions  (PoE,  HE,  PoP2,  and  HP2)  as  well  as  the  Total 
Electron  Content  (TEC). 

PIM  Inputs 

The  PIM  science  module  requires  the  following  inputs: 

Global  Parameters:  Year,  Day,  UT,  Kp,  SSN,  and  P10.7.  Either  SSN  or  P10.7  can  be  omitted 
if  the  appropriate  FIO.  7 /SSN  option  is  chosen  as  discussed  below. 
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F2  Model  Norm: 


E  Model  Norm: 


IMF  By: 
IMF  Bz: 

FI0.7/SSN: 


Write  to  File: 
Ext: 


This  option  tells  PIM  whether  to  normalize  the  eritieal  frequeney  of  the 
ionospherie  F2-layer  (FoF2). 

None:  No  FoF2  normalization  is  performed. 

URSI:  FoF2  normalization  is  performed  using  the  URSI  global 

empirieal  model. 

This  option  tells  PIM  whether  to  normalize  the  eritieal  frequeney  of  the 
ionospherie  E-layer  (FoE). 

None:  No  FoE  normalization  is  performed. 

Empirieal:  FoE  normalization  is  performed  using  a  semi-empirieal 

model. 

The  orientation  of  the  Y-eomponent  of  the  interplanetary  magnetie  field 
may  be  set  to  Positive  or  Negative. 

The  orientation  of  the  Z-eomponent  of  the  interplanetary  magnetie  field 
may  be  set  to  Positive,  Zero,  or  Negative. 

The  relationship  between  the  instantaneous  El 0.7  em  solar  radio  flux  and 
the  sun  spot  number  ean  be  set  several  ways,  namely 

Deeoupled:  The  sun  spot  number  and  solar  radio  flux  will  be  treated 

as  independent  quantities. 

F10.7->SSN:  The  sun  spot  number  will  be  estimated  from  the  solar 

radio  flux. 

SSN->F10.7:  The  solar  radio  flux  will  be  estimated  from  the  sun  spot 

number. 

Speeifies  the  base  file  name  that  the  PIM  results  should  be  stored  in. 

The  Ext  option  must  be  seleeted  if  eleetron  densities  are  generated  in 
dynamie  mode  and  if  RAYTRACE-APP  is  to  be  used  to  traee  a  set  of  rays 
at  eaeh  time  step,  i.e.,  seleeting  this  option  will  ereate  a  series  of  files 
(with  the  base  file  name  speeified  above)  with  sequentially  numbered 
extensions. 


PIM  Outputs 

PIM  returns  the  spatial  distribution  of  the  following  ionospherie  quantities, 

Elee.  Density:  The  eleetron  density  (#/em^)  is  returned  as  a  3D  Gridded  Data  Set. 

FoE:  The  eritieal  frequeney  (MHz)  of  the  E  layer  of  the  ionosphere  is  returned 

as  a  2D  Gridded  Data  Set  in  latitude  and  longitude. 

HE:  The  altitude  (km)  of  the  peak  of  the  ionospherie  E  layer  is  returned  as  a 

2D  Gridded  Data  Set  in  latitude  and  longitude. 

FoF2:  The  eritieal  frequeney  (MHz)  in  the  F2  layer  of  the  ionosphere  is  returned 

as  a  2D  Gridded  Data  Set  in  latitude  and  longitude. 
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HF2: 


TEC: 


The  altitude  (km)  of  the  peak  of  the  ionospherie  F2  layer  is  returned  as  a 
2D  Gridded  Data  Set  in  latitude  and  longitude. 

The  total  eleetron  eontent  (height  integrated  electron  density  in  units  of 
10'^  cm'^)  is  returned  as  a  2D  Gridded  Data  Set  in  latitude  and  longitude. 
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The  PPS  Science  Module  (V2.5.1  and  Static  Only) 

Proton  Prediction  System  (PPS) 

96 

D.  Smart  and  M.  Shea,  Air  Force  Research  Laboratory 

Kahler,  S.W.,  E.W.  Cliver,  and  A.G.  Ling,  Validating  the  Proton  Predition 
System  (PPS),  J.  Atmos.  Solar-Terr.  Phys.,  69,  43-49  (2007)  [see  fde 
$AFGS_Home\models\REFS\KahlerCliverLing2007.pdf] 

Smart,  D.F.,  and  M.A.  Shea,  PPS76  -  A  Computerized  “Event  Mode” 
Solar  Proton  Porecasting  Technique,  in  Solar  Terrestrial  Predictions 
Proceedings,  edited  by  R.P.  Donnelly,  U.S.  Department  of  Commerce, 
NOAA/ERL,  1,  p.  406  (1979) 

Smart,  D.P.,  and  M.A.  Shea,  PPS-87;  A  New  Event  Oriented  Solar  Proton 
Prediction  Model,  yfJv.  Space  Res.,  P,  No.  10,  (10)281-(10)284,  (1989) 

Smart,  D.P.,  and  M.A.  Shea,  Modeling  the  Time-Intensity  Profile  of  Solar 
Plare  Generated  Particle  Pluxes  in  the  Inner  Heliosphere,  Adv.  Space  Res., 
12,  No.  2-3,  (2)303-(2)313,  (1992) 

Note:  It  is  recommended  that  AP-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

PPS  Overview 

The  PPS  Science  module  is  based  on  the  Proton  Prediction  System  (PPS)  software  program^ 
developed  by  the  Air  Porce  Research  Eaboratory.  Previous  versions  for  DOS  PCs  have  been 
released.  As  Smart  and  Shea  (1979)  explain: 

“[PPS]  has  been  developed  to  generate  a  computerized  time-intensity  profile  of  the  solar 
proton  intensity  expected  at  the  Earth  after  the  occurrence  of  a  significant  solar  flare  on 
the  sun.  This  procedure  is  a  combination  of  many  pieces  of  independent  research  and 
theoretical  results.  It  is  not  a  comprehensive  self-consistent  analytical  method,  but  is  a 
construction  of  selected  experimental  and  theoretical  results  from  the  entire  domain  of 
solar-terrestrial  physics.” 

PPS  has  been  constructed  to  model  protons  that  are  accelerated  during  energetic  solar  events 
(i.e.,  those  associated  with  flares)  near  the  solar  surface.  It  does  NOT  model  proton  acceleration 
that  might  occur  in  an  interplanetary  shock  propagating  towards  the  Earth.  Most  proton  events  at 
Earth  are  the  result  of  protons  accelerated  near  the  solar  surface.  “Hybrid”  solar  flare¬ 
interplanetary  shock  accelerated  events  occur  on  the  order  of  a  dozen  times  during  a  solar  cycle. 
While  such  hybrid  events  are  infrequent,  they  can  be  quite  large. 


Model  Name: 
Version: 
Developer: 
References: 


^  Preliminary  Software  User’s  Manual  for  the  Proton  Prediction  System,  Critical  Design  Review 
Data  Package  for  the  Proton  Prediction  Model,  Prepared  by  C.  B.  Tang,  Inc  for  contract  no. 
PI9628-87-C-0044,  March  (1987) 
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The  PPS  system  is  designed  to  generate  a  solar  proton  flux  distribution  in  spaee  that  will  mateh 
the  Earth-observed  statistieal  average  intensity-time  proflle,  flux  and  time-of-maximum  speetra 
found  by  spaoeeraft  measurements  to  be  assoeiated  with  solar  aetivity  at  a  speeifie  helio¬ 
longitude  with  respeet  to  the  Earth. 

The  solar  proton  flare  event  diagnosties  of  the  1970’s  and  1980’s  are  identieal  to  the  fast  CME 
proxies  of  the  1990’s.  The  eoneept  of  partiele  aeeeleration  in  the  solar  eorona  by  fast  CME’s  is 
still  eonsistent  with  the  fundamental  parameters  of  the  Proton  Predietion  system.  It  is  assumed 
that  the  maximum  possible  flux  will  be  eneountered  on  the  Arehimedean  spiral  path  leading  from 
the  solar  aetive  region.  It  is  also  assumed  that  there  is  a  relation  between  the  energy  in  the 
eleetromagnetie  emission  parameters  and  the  proton  flux  observed  in  spaee.  It  is  further  assumed 
that  there  will  be  a  helio-longitudinal  gradient  of  particle  intensity  in  space  that  decreases  one 
order  of  magnitude  per  radian  of  angular  separation  for  the  most  favorable  propagation  path.  The 
particle  flux  intensity  in  space  will  be  mapped  in  accordance  with  the  Archimedean  spiral 
conflguration  of  the  interplanetary  magnetic  fleld.  The  connection  of  the  Earth  to  the  solar  active 
region  via  the  interplanetary  magnetic  fleld  is  a  controlling  parameter  in  the  prediction  of  how 
much  solar  particle  flux  will  be  received  at  the  Earth. 

The  PPS  system  is  designed  to  take  many  input  parameters.  The  flrst  available  reports  of  intense 
radio  or  solar  X-ray  emissions,  from  onset  to  maximum,  can  be  utilized  for  a  quick  prediction 
mode.  This  allows  for  a  possible  prediction  of  the  solar  proton  event  before  the  solar  protons 
reach  the  Earth.  Unfortunately,  this  quick  prediction  mode  based  on  peak  flux  data  is  also  the 
least  accurate.  The  PPS  prediction  accuracy  essentially  doubles  when  event  integrated  data  are 
used  for  the  input. 

The  input  needed  to  specify  the  time  and  intensity  of  the  solar  flare  source  in  the  PPS  can  take 
two  forms:  (a)  solar  radio  emissions  observed  by  the  USAE  RSTN  sites  at  8800,  4995,  2695, 
1415,  606  MHz  or  10  cm  (b)  soft  X-ray  events  observed  by  the  GOES  satellites  in  either  the  0.5- 
4.0  or  1-8  Angstrom  bands.  The  location  of  the  solar  flare  is  determined  from  H-alpha 
observations  made  by  the  USAE  SOON  sites.  PPS  contains  an  “expert”  mode  enabling  the  user 
to  override  certain  PPS  default  values  used  to  classify  the  proton  energy  spectra  at  the  Earth,  but 
its  use  is  NOT  recommended  unless  the  user  has  considerable  experience  in  interpreting  solar 
proton  events. 

The  version  of  PPS  implemented  in  AE-GEOSpace  provides  output  showing  the  time 
dependence  of  proton  fluxes  in  several  differential  and  integral  energy  channels  relevant  to  the 
GOES  satellite.  Also  given  are  the  time  intervals  for  which  the  >  5  MeV,  >10  MeV  and  >  50 
MeV  integral  proton  fluxes,  such  as  measured  on  the  GOES  satellites,  are  above  the  threshold 
value  of  10  particles/(cm^-s-sr).  The  time  and  value  of  the  peak  response  in  each  of  the  above 
channels  during  the  solar  proton  event  is  estimated.  Several  user-specific  quantities  are  also 
calculated  including  forecasts  for  the  riometer  absorption  in  Thule,  Greenland,  maximum 
radiation  dosage  for  pilots  in  high-flying  aircraft  above  the  poles,  and  maximum  radiation  dosage 
to  be  expected  both  inside  and  outside  a  polar-orbiting  space  shuttle. 

PPS  Inputs 

The  PPS  science  module  requires  the  following  inputs: 

Global  Parameters:  Year,  Day,  UT  (used  to  initialize  event  onset  time  and  time  of  maximum) 
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Specify  Data:  The  user  can  choose  whether  solar  X-Ray  emissions  as  measured  by  the 

GOES  satellite  or  solar  Radio  emission  data  as  measured  by  the  USAF 
RSTN  sites  are  to  be  used  to  parameterize  the  solar  flare. 

Specify  Flux  Type:  The  user  chooses  whether  Peak  Flux  or  Integrated  Flux  values  are  to  be 

used  to  characterize  the  amplitude  of  the  X-Ray  or  solar  Radio  emissions. 

X-ray  Data:  X-Ray  is  chosen  as  the  data  type  (and  Use  X-ray  classification  input  is 

not  selected),  the  user  chooses  whether  to  use  either  the  0.5  -  4.0  Angstrom 
ox  1.0  -  8.0  Angstrom  bands. 

Radio  Frequency:  If  Radio  is  chosen  as  the  data  type,  the  user  selects  which  fixed  frequency 

band,  centered  at  8800,  4995,  2695,  or  1415  MHz,  is  to  be  used. 

Event  Onset  Time:  Depending  on  the  choice  of  data  type,  the  onset  time  of  either  the  radio  or 
X-ray  event  in  the  format  MM/DDAfY  HH:MM. 

Time  of  Maximum:  Depending  on  the  choice  of  data  type,  the  time  of  the  maximum  amplitude 
of  either  the  radio  or  X-ray  event  in  the  format  MM/DDAfY  HH:MM. 

Flare  lat  (deg  N):  The  solar  latitude,  in  degrees  North,  of  the  solar  flare  associated  with 

either  the  X-ray  or  radio  event.  This  information  can  be  obtained  from  H- 
alpha  observations  by  the  FISAF  SOON  sites.  Degrees  South  are  entered 
as  negative  numbers. 

Flare  Ion  (deg  W):  The  solar  longitude,  in  degrees  West,  of  the  solar  flare  associated  with  the 
X-ray  or  radio  event.  This  information  can  be  obtained  from  H-alpha 
observations  by  the  USAF  SOON  sites.  Degrees  East  are  entered  as 
negative  numbers. 

Use  X-ray  classification  input?:  If  X-Ray  is  the  input  data  type  and  Peak  Flux  is  the  flux  type,  the 
user  can  select  here  whether  to  use  the  standard  X-ray  event  classification 
scheme  to  specify  the  magnitude  of  the  peak. 

Peak  class.:  If  the  X-Ray  classification  type  is  used  to  specify  the  peak  magnitude  of  an 

X-ray  event,  the  user  enters  the  peak  X-ray  level  measured  by  either  the 
0. 5-4.0  or  1-8  Angstrom  (depending  on  the  X-ray  band  selected  above)  X- 
ray  instrument  on  the  GOES  satellites.  These  values  are  entered  with  a 
classification  letter  and  a  numeric  field.  The  usual  X-ray  event 
classification  letters  C,  M,  and  X  are  used  with  a  numeric  field  to  multiply 
the  flux  level.  The  range  of  allowed  values  is  C  1.0  through  X99.0. 

“Event  amplitude”:  The  descriptor  for  this  text  box  changes  depending  on  what  options  for 
input  data  have  been  selected.  The  beginning  of  the  line  plainly  states  the 
type  of  input  data  required  and  what  units  need  to  be  used,  that  is. 

Peak  X-Ray  =  Peak  X-ray  emission  in  units  of  ergs/cm  /s  (if  the  X-ray 
classification  option  has  not  been  selected). 

Integ.  X-Ray  =  Integrated  X-ray  emission  in  units  of  Joules/cm  ' 

22 

Peak  Radio  =  Peak  Radio  emission  in  Solar  Flux  Units  (=1.0  x  10’ 
W/m"  Hz) 
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Integ.  Radio  =  Integrated  Radio  emission  in  units  of  SFU-s 

The  six  eharaeter  eode  at  the  end  of  the  deseriptor  line  summarizes  the 
input  and  has  the  following  format:  AAANNB,  where, 

AAA  =  XRY  X-Ray  has  been  seleeted  as  the  input  data  type 

RAD  if  Radio  has  been  seleeted  as  the  input  data  type 

NN  =  54  if  the  0. 5-4. 0  Angstrom  X-Ray  data  band  has  been  ehosen 

18  if  the  i.  0-5.0  Angstrom  X-Ray  data  band  has  been  ehosen 

14  if  the  1415  MHz  Radio  Frequeney  has  been  chosen 

26  if  the  2695  MHz  Radio  Frequency  has  been  chosen 

49  if  the  4995  MHz  Radio  Frequency  has  been  chosen 

88  if  the  8800  MHz  Radio  Frequency  has  been  chosen 

B  =  P  if  the  Peak  Flux  has  been  chosen 

I  if  the  Integrated  Flux  has  been  chosen 

Amplitude  data  can  be  entered  in  the  standard  integer,  real  number,  or 
exponential  formats 

Expert  Mode:  This  mode  allows  the  user  to  override  certain  PPS  default  input  quantities, 

i.e.,  spectral  slope,  spectra  type  (differential  or  integral),  flux 
normalization,  time  of  flux  maximum,  and  GOES  energy  channel. 

Note:  Use  of  the  Expert  Mode  is  NOT  recommended  unless  the  user  has  considerable 
experience  in  interpreting  solar  proton  events. 

The  remainder  of  the  buttons  in  the  PPS  environment  window  control  various  output  options  and 
are  described  below. 

PPS  Outputs 

PPS  returns  a  text  message  window  containing  the  results  of  the  model  calculations  and  a 
summary  of  the  input  parameters.  The  model  provides  the  following  predictions: 

-  Maximum  day  polar  riometer  absorption  at  Thule,  Greenland,  in  db,  and  the  time  that  this 
maximum  will  occur  in  HH:MM  (UT)  MON  DD.  This  prediction  is  valid  if  it  is  daytime  at 
Thule  (i.e.,  between  6:00  and  18:00  EOCAL  Thule  time)  during  the  interval  of  the  solar 
event.  Note  that  ionospheric  absorption  is  a  function  of  the  solar  zenith  angle. 

-  Maximum  night  polar  riometer  absorption  at  Thule,  Greenland,  in  db,  and  the  time  that  this 
maximum  will  occur  in  HH:MM  (UT)  MON  DD.  This  prediction  is  valid  if  it  is  nighttime  at 
Thule  (i.e.,  between  18:00  and  6:00  EOCAL  Thule  time)  during  the  interval  of  the  solar 
event. 

-  Maximum  dose  rate  expected  at  an  altitude  of  70,000  feet  above  the  polar  regions,  in 
mRad/hr,  and  time  this  maximum  will  occur  in  HH:MM  (UT)  MON  DD.  This  output  can  be 
used  to  estimate  pilot  dosages. 
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-  Maximum  dose  rate  expeeted  at  an  altitude  of  50,000  feet  above  the  polar  regions,  in 
mRad/hr,  and  time  this  maximum  will  oeeur  in  HH:MM  (UT)  MON  DD.  This  output  ean  be 
used  to  estimate  pilot  dosages. 

-  Maximum  dose  rate  above  the  polar  regions  at  altitudes  eorresponding  to  typieal  spaee 
shuttle  orbits  (about  250  km).  Dose  rates  in  Rad/hr  are  given  for  both  Extra  Vehicular 
Activities  (no  shielding)  and  inside  the  shuttle  behind  2  g/cm^of  Aluminum  shielding.  The 
time  of  maximum  is  also  given  in  HH;MM  (UT)  MON  DD. 

-  The  interval  of  time  for  which  the  >  5  MeV  proton  flux  near  Earth  (e.g.,  as  measured  on  the 
GOES  satellites)  will  be  above  the  threshold  value  of  10  particles/(cm^-s-sr)  in  the  form 
MON  DD  HH:MM  (UT,  start  time)  -  MON  DD  HH:MM  (UT,  end  time).  The  maximum  flux 
value,  in  particles/(cm^-s-sr),  and  the  time  of  the  maximum  in  HH:MM  (UT)  MON  DD  are 
given.  Also  estimated  is  the  >  5  MeV  fluence  (=  flux*time)  for  the  duration  of  the  event. 


-  The  interval  of  time  for  which  the  >10  MeV  proton  flux  near  Earth  (e.g.,  as  measured  on  the 
GOES  satellites)  will  be  above  the  threshold  value  of  10  particles/(cmNs-sr)  in  the  form 
MON  DD  HH:MM  (UT,  start  time)  -  MON  DD  HH:MM  (UT,  end  time).  The  maximum  flux 
value,  in  particles/(cm^-s-sr),  and  the  time  of  the  maximum  in  HH;MM  (UT)  MON  DD  is 
given.  Also  estimated  is  the  >10  MeV  fluence  (=  flux*time)  for  the  duration  of  the  event. 


-  The  interval  of  time  for  which  the  >  50  MeV  proton  flux  near  Earth  (e.g.,  as  measured  on  the 
GOES  satellites)  will  be  above  the  threshold  value  of  10  particles/(cm^-s-sr)  in  the  form 
MON  DD  HH:MM  (UT,  start  time)  -  MON  DD  HH:MM  (UT,  end  time).  The  maximum  flux 
value,  in  particles/(cm^-s-sr),  and  the  time  of  the  maximum  in  HH:MM  (UT)  MON  DD  is 
given.  Also  estimated  is  the  >  50  MeV  fluence  (=  flux*time)  for  the  duration  of  the  event. 


EPS  also  provides  three  plots  selectable  from  buttons  in  the  PPS  Environment  window: 


DiffElux-GOES: 


DiffElux-GWC: 


Integ  Elux: 


Differential  proton  flux  as  a  function  of  time  at  geosynchronous  altitude 
for  the  energy  ranges  measured  by  the  Space  Environment  Monitor  on  the 
GOES  satellites,  i.e.,  1-4  MeV,  4-8  MeV,  8-16  MeV,  and  16-215  MeV. 
The  dotted  red  line  corresponds  to  the  threshold  of  10  protons/(cm^-s-sr). 

Differential  proton  flux  as  a  function  of  time  for  the  energy  ranges  0.8-1. 2 
MeV,  4-6  MeV,  9-11  MeV,  14-16  MeV,  and  49-5 1  MeV.  The  dotted  red 
line  corresponds  to  a  threshold  of  10  protons/(cm^-s-sr). 

Integral  proton  flux  as  a  function  of  time  at  geosynchronous  altitude  for 
energy  ranges  measured  by  the  Space  Environment  Monitor  on  the  GOES 
satellites,  i.e.,  at  greater  than  10,  30,  50,  100,  and  500  MeV,  respectively. 
The  dotted  red  line  corresponds  to  a  threshold  of  10  protons/(cmNs-sr). 


The  following  output  options  are  also  selectable  from  the  PPS  Environment  window. 

Plot  Options:  This  widget  allows  one  to  set  the  Y-axis  min,  max  and  number  of  tics  for 

the  plots.  The  Auto  button  gives  (rounded)  limits  spanning  the  data  and  the 
default  is  set  at  -5  to  5  (log  10). 

Display  Text:  Clicking  the  Display  Text  button  displays  the  text  window  if  it  was  closed. 
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The  SAAMAPS-2007  Science  Module  (Static  Only) 

Model  Name:  SAAMAPS-2007 

Version:  July  2007 

Developer:  Air  Force  Research  Laboratory  and  Boston  College 

Reference:  Ginet,  G.  P.,  Madden,  D.,  Dichter,  B.K.,  and  Brautigam,  D.H.,  Energetic 

proton  maps  for  the  South  Atlantic  anomaly,  AFRL-RV-HA-TR-2008- 
1060,  Air  Force  Research  Laboratory,  Hanscom  AFB  MA  (2008),  ADA 
485155  [see  $AFGS_HOME\models\REFS\SAAMAPS_2007.pdf] 

Note:  It  is  recommended  that  AF-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

SAAMAPS-2007  Overview 

For  low-Earth  orbit  (LEO)  satellites,  anomalies  related  to  single  event  effects  (SEEs)  can  result 
from  interaction  with  the  high-energy  radiation  belt  protons.  The  dominant  source  of  proton 
fluence  (outside  of  solar  proton  events)  is  the  South  Atlantic  Anomaly  (SAA),  a  localized  region 
at  fixed  altitude  with  high  flux  intensities  resulting  from  the  asymmetry  in  the  Earth’s  magnetic 
field.  As  summarized  by  Ginet  et  al.  (2008),  previously,  the  location  of  the  SAA  was  often 
determined  by  using  the  proton  intensity  maps  derived  from  the  NASA  AP  radiation  belt 
climatology  models  (see  The  NASAPRO  Science  Module  chapter  of  this  document  for  details). 
However,  with  the  SAA  drifting  westward  approximately  0.3  degrees/year  updates  are  needed. 
Subsequently,  an  improved  set  of  single  event  effects  maps  was  developed  from  data  taken  by 
the  Air  Force  APEX  and  CURES  satellites  for  epoch  1990-1996  (see  The  SEEMAPS-1998 
Science  Module  chapter  of  this  document).  Most  recently,  the  South  Atlantic  Anomaly  Maps 
(SAAMAPS)  represented  in  this  science  module  were  developed  by  Ginet  et  al.  (2008)  who 
confirmed  the  continued  westward  drift  of  the  SAA.  SAAMAPS-2007  provides  access  to  a 
geographically  tagged  database  of  energetic  proton  flux  intensities  for  the  epoch  2000-2006 
based  on  data  from  the  Compact  Environment  Anomaly  Sensor  (CEASE)  flown  onboard  the  Tri- 
Service  Experiment-5  (TSX-5)  satellite  in  a  410  km  x  1710  km,  69°  inclination  orbit. 

SAAMAPS-2007  Inputs 

The  SAAMAPS  Science  Module  requires  the  user  to  specify  the  following  information  to 
determine  which  data  set  to  use  in  mapping  the  data. 

Altitude:  This  parameter  determines  which  of  the  proton  flux  data  sets  representing 

26  altitude  bins  (400  and  1,650  km)  is  to  be  considered.  The  altitude  range 
of  each  value  extends  50  km  above  the  listed  value.  Select  H//  at  the  top  of 
the  list  to  load  all  altitudes  or  select  a  single  altitude  (km)  from  the  list. 

SAAMAPS-2007  Outputs 

The  SAAMAPS  Science  Module  returns  a  3D  Gridded  Data  Set  of  proton  flux  (#/cm^-sec-str) 
for  5  integral  energy  channels  (>23,  >38,  >66,  and  >94  MeV)  for  the  selected  altitude  bin  (or  all 
bins).  The  output  map  resolution  is  fixed  (3°  latitude  x  3°  longitude  x  50  km). 
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The  SEEMAPS-1998  Science  Module  (Static  Only) 

SEEMAPS-1998 
September  1998 
Radex,  Inc.  (now  AER,  Inc.) 

Gussenhoven,  M.S.,  E.G.  Mullen,  D.A.  Hardy,  D.  Madden,  E.  Holeman, 

D.  Delorey,  and  E.  Hanser,  Eow  Altitude  Edge  of  the  Inner  Radiation  Belt: 
Dose  Models  from  the  APEX  Satellite,  IEEE  Trans.  Nucl.  Sci.,  43,  2035- 
2042  (1995) 

Mullen,  E.G.,  G.  Ginet,  M.S.  Gussenhoven,  and  D.  Madden,  SEE  Relative 
Probability  Maps  for  Space  Operations,  IEEE  Trans.  Nuc.  Sci.,  45,  2954- 
2963  (1998) 

Sawyer,  D.M.  and  J.I.  Vette,  AP-8  Trapped  Proton  Environment  for  Solar 
Maximum  and  Solar  Minimum,  NSSDC  WDC-AR&S  76-06,  NASA-GSFC 
TMX-72605,  Greenbelt,  MD  (1976) 

Note:  It  is  recommended  that  AE-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

SEEMAPS  Overview 

The  Single  Event  Effects  Maps  (SEEMAPs)  are  a  geographically  tagged  database  of  the  relative 
probability  for  satellite  on-board  micro-electronics  to  suffer  single  event  effects  in  the  low  Earth 
orbit  (EEO)  regime.  Until  now,  the  most  readily  accessible  and  usable  means  to  determine  the 
SEE  risk,  either  for  design  or  operations,  was  by  using  proton  contours  from  the  NASA  Particle 
Maps  [Sawyer  and  Vette,  1976].  However,  both  data  and  our  physical  understanding  of  the 
Earth’s  magnetic  field  movement  indicate  that  the  location  of  the  energetic  proton  belts  has 
changed  significantly  since  these  maps  were  made  in  1970. 

The  SEEMAPs  are  an  improved  model  for  determining  relative  risk  assessment  from  SEEs  in  the 
near-Earth  space  in  the  present  epoch  based  on  data  taken  from  the  Advanced  Photovoltaic  and 
Electronics  (APEX)  and  Combined  Radiation  and  Release  Experiment  (CURES)  satellites.  The 
data  cover  the  period  from  July  1990  to  October  1991  (CURES,  near  solar  maximum)  and  from 
August  1994  to  May  1996  (APEX,  near  solar  minimum).  A  comparison  of  radiation  dose  from 
the  two  spacecraft  as  well  as  from  the  Defense  Meteorological  Satellite  Program  (DMSP)  P7 
spacecraft  for  the  previous  solar  minimum  period  (1984-1987)  is  given  by  Gussenhoven  et  al. 
[1995].  This  work  showed  that  there  was  a  small  variation  in  proton  dose  over  the  last  solar 
cycle.  The  fact  that  the  change  was  small  for  inner  belt  protons  gives  us  reason  to  believe  that  the 
combined  APEX  and  CURES  databases  give  a  near  worst-case  model  (solar  minimum)  useful 
for  orbit  trade-off  studies  and  mission  operations  planning. 

An  excerpt  from  Mullen  et  al.  [1998]  describes  the  basic  SEEMAP  construction  and  capability: 

“Normalized  flux  and  dose  data  for  protons  with  energies  >50  MeV  are  used  to  produce 
contour  maps  of  relative  probabilities  of  experiencing  SEEs  in  the  Earth’s  inner  radiation 
belt.  The  data  were  taken  on  the  APEX  and  CRRES  satellites.  To  make  the  maps,  the 
data  are  averaged  in  3°  x  3°  bins  in  geographic  latitude  and  longitude,  and  in  50  km  steps 
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in  altitude.  All  geographic  longitudes  and  latitudes  less  than  or  equal  to  70°  are  covered. 

The  altitude  range  extends  from  350  km  to  14,000  km.  This  geographic  range  includes 
the  complete  region  of  inner  belt  >  50  MeV  protons,  except  in  the  South  Atlantic 
Anomaly  region  below  350  km.  The  maps  easily  locate  regions  of  high  risk  for  SEEs  and 
are  designed  primarily  for  use  in  space  mission  planning  and  operations.  The  data  base 
includes  the  added  proton  peak  following  the  March  1991  magnetic  storm,  but  does  not 
include  SEE  probabilities  in  the  polar  cap  region  associated  with  high  energy  solar 
particle  events.” 

Though  the  SEE  relative  probability  maps  are  constructed  from  data  sets  of  flux  rates 
corresponding  to  >  50  MeV  particles  depositing  energy  in  the  APEX  and  CURES  dosimeters, 
these  flux  rates  were  carefully  compared  with  both  the  >50  MeV  dose  rate  and  single  event 
upsets  measured  in  a  solid  state  tape  recorder  on-board  APEX.  The  correlation  was  found  to  be 
good.  Relative  probabilities  were  computed  by  dividing  the  dosimeter  flux  rate  by  a 
normalization  factor  of  2360.45,  which  gives  relative  probability  values  in  the  range  of  0  to  5.5. 
This  factor  was  based  on  APEX  measurements  as  explained  in  Mullen  et  al.  [1998]; 

“...  a  normalization  factor  is  calculated  from  the  average  flux  rate  for  the  HILET  A  Dome 
4  [dosimeter]  between  the  altitudes  of  1,000  and  1,050  km  for  data  points  between  1,000 
and  5,000  counts/s.  This  altitude  and  count  rate  level  were  chosen  because  they  are  near 
the  middle  of  the  altitude  range,  have  sufficient  points  for  good  statistics,  are  the  highest 
count  rates  for  the  altitude  range,  and  are  most  easily  remembered  (>1000  counts/s  at 
1000  km).” 

The  SEEMAPS  should  be  most  useful  for  a  space  system  operator  to  a)  tell  when  and  how  the 
spacecraft  enters  regions  of  high  intensity  (like  the  SAA)  and  the  time  spent  in  the  region,  b) 
estimate  how  many  upsets  to  expect  in  every  region  by  keeping  track  of  when  and  where  upsets 
occur  and  then  using  the  normalization  factors,  and  c)  determine  the  factor  to  go  from 
normalized  values  to  upsets/device/unit  time/region  once  the  upset  data  base  is  large  enough. 

SEEMAPS  Inputs 

The  SEEMAPS  Science  Module  requires  the  user  to  specify  the  following  information  to 
determine  which  data  set  to  use  in  mapping  the  data. 

Altitude  Bins:  The  altitude  bins  parameter  determines  which  of  the  proton  flux  data  sets 

corresponding  to  bins  between  350  and  15,000  km  is  to  be  considered. 
Select  the  All  to  load  all  altitude  or  select  One  to  load  a  single  altitude  and 
highlight  one  of  altitude  ranges  in  the  Bin  Ranges  (Km)  list. 

Activity:  The  activity  parameter  specifies  whether  the  Quiet  (obtained  before  the  24 

March  1991  storm)  ox  Active  (obtained  after  the  24  March  1991  storm) 
proton  flux  data  sets  are  to  be  used.  This  parameter  is  the  same  as  that 
used  in  the  CRRESPRO  module  (see  the  CRRESPRO  Science  Module). 


SEEMAPS  Outputs 

The  SEEMAPS  Science  Module  returns  a  3D  Gridded  Data  Set  of  the  proton  flux  (#/sec)  and 
relative  probability  value  {RELATIVE  PROB)  for  the  selected  altitude  bin  (or  all  bins)  and 
activity  level. 
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The  STOA  Science  Module  (V2.5.1  and  Static  Only) 

Model  Name:  Shoek  Time  of  Arrival  (STOA) 

Version:  1.0  (1987) 

Developer:  D.  Smart,  Air  Force  Research  Laboratory;  M.  Dryer  and  L.D.  Lewis, 

NOAA  Space  Environment  Center 

References:  Fry,  C.D.,  M.  Dryer,  Z.  Smith,  W.  Sun,  C.S.  Deehr,  and  S.-I.  Akasofu, 

Forecasting  solar  wind  structures  and  shock  arrival  times  using  an 
ensemble  of  models,  J.  Geophys.  Res.,  108{A2),  1070, 
doi:  10.1 029/2002 JA009474(2003) 

Hilmer,  R.V.,  G.P.  Ginet,  K.  Kadinsky-Cade,  S.  Quigley,  D.T.  Decker, 
P.H.  Doherty,  Space  Environment  Models  Addressing  Operational 
Hazards:  An  AF-GEOSpace  Perspective  on  Current  Capabilities, 

American  Institute  of  Aeronautics  and  Astronautics,  AIAA  2000-0366, 
from  38th  Aerospace  Sciences  Meeting,  10-13  January  2000,  Reno  NV, 
2000. 

Smart,  D.F.,  M.A.  Shea,  M.  Dryer,  A.  Quintana,  F.C.  Gentile  and  A.A. 
Bathurst,  Estimating  the  Arrival  Time  of  Solar  -  Flare  -  Initiated  Shocks 
by  Considering  them  to  be  Blast  Waves  Riding  over  the  Solar  Wind,  in 
Simon,  P.A.,  G.  Heckman  and  M.A.  Shea,  Eds.,  Solar-Terrestrial 
Predictions:  Proceedings  of  a  Workshop  at  Meudon,  France,  June  18-22, 
1984,  U.S.  Government  Printing  Office,  Washington,  D.C.,  pp.  471-481 
(1986) 

Smart,  D.F.  and  M.A.  Shea,  A  Simplified  Model  for  Timing  the  Arrival  of 
Solar  Flare-Initiated  Shocks,/.  Geophys.  Res.,  90,  I83-I90  (1985) 

Note:  It  is  recommended  that  AF-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

STOA  Overview 

The  sudden  release  of  energy  into  the  solar  atmosphere  will  create  a  shock  wave.  The  STOA 
model  applies  the  Sedov  similarity  theory  to  the  general  characteristics  of  the  interplanetary 
medium  [Sedov,  Similarity  and  Dimensional  Methods  in  Mechanics,  Academic  Press,  New  York, 
1959].  The  STOA  concept  is  a  blast  wave  propagating  over  the  pre-existing  solar  wind.  When  an 
interplanetary  shock  has  been  generated  by  a  solar  disturbance,  the  STOA  science  module  can  be 
invoked  to  predict  the  arrival  time  of  the  shock  at  the  Earth  or  at  another  ecliptic  plane  location. 
We  refer  to  the  shock-producing  solar  events,  whether  they  are  coronal  mass  ejections  or  solar 
flares,  as  “solar  flares,”  because  the  model  was  originally  developed  assuming  that  solar  flares 
were  the  drivers  for  the  interplanetary  shocks. 

The  STOA  shock  speed  profile  as  a  function  of  radial  distance  has  been  found  to  compare 
favorably  with  2  1/2-D  MHD  simulations  of  interplanetary  shocks  propagating  along  the  flare- 
radial  direction,  for  test  cases  where  the  initial  shock  speeds  were  identical  (see  review  by  Wu 
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[Space  Science  Reviews,  32,  115,  1982]).  The  MHD  models  simulate  the  behavior  of  solar  flare 
initiated  shoek  waves  propagating  through  interplanetary  spaee. 

The  STOA  arrival  time  is  ealeulated  by  modeling  the  shoek  propagation  in  two  phases:  a 
“driven”  phase  and  a  “blast”  phase.  During  the  initial  driven  phase  the  shoek  is  assumed  to  be 
driven  by  the  solar  flare.  It  is  assumed  that  the  shoek  disturbanee  originates  in  the  solar 
atmosphere  at  a  distanee  R=0.007  AU  from  the  eenter  of  the  Sun.  A  eonstant  speed  is  assigned  to 
this  driven  phase  and  is  assumed  to  be  given  by  the  frequeney  drift  rate  of  the  Type  11  radio  burst 
with  the  onset  time  eoineiding  with  the  beginning  of  the  burst.  The  end  time  of  the  driven  phase 
is  the  time  when  the  soft  X-ray  emission  power  has  deeayed  to  half  of  the  log  of  the  maximum 
flux  above  the  pre-event  baekground.  The  radial  distanee  eovered  by  the  driven  phase  is  given  by 
the  produet  of  the  Type  11  drift  speed  multiplied  by  the  driver  time. 

The  distanee  from  the  Sun’s  eenter  to  the  end  point  of  the  driven  phase  in  a  flare  radial  direetion 
is 

Rd=  0.007 +  VdTd  (AU). 

The  initial  eondition  simulated  by  STOA  is  a  shoek  front  that  may  extend  aeross  a  major  part  of 
the  Sun,  with  a  shoek  front  speed  profde  given  by 

V9=Vrf  with  f  =  (eos(0)+l)/2 

where  0  is  the  angle  measured  at  the  eenter  of  the  Sun  between  the  flare  radial  direetion  and  any 
other  radial  direetion.  The  driven  distanee  at  an  angle  0  is 

Rde  =  0.007  +  f  Vd  Td  (AU). 

After  the  driven  phase  it  is  assumed  that  the  propagation  of  the  disturbanee  through  the  inter¬ 
planetary  medium  ean  be  deseribed  as  a  blast  wave  superimposed  on  the  preexisting  solar  wind. 
Only  the  shoek  front  or  leading  edge  of  the  blast  wave  is  eonsidered  in  this  model;  no  informa¬ 
tion  is  provided  on  the  strueture  of  the  shoek  wave.  The  average  radial  blast  wave  speed  is 
obtained  by  integrating  the  blast  wave  equation  in  the  flare  radial  direetion. 

In  the  interplanetary  medium  it  is  assumed  that  the  density  is  proportional  to  the  inverse  square 
of  the  distanee  R  from  the  eenter  of  the  Sun,  and  that  the  blast  wave  speed  deereases  as  R'  .  The 
average  radial  blast  wave  speed  is  projeeted  onto  the  Sun-observer  direetion  using  the 
foreshortening  faetor  deseribed  earlier.  It  is  assumed  that  the  speed  anisotropy  adopted  for  the 
driven  phase  persists  through  the  blast  phase.  Finally,  the  average  speed  of  the  disturbanee 
during  the  blast  phase  is  the  average  blast  wave  speed  in  the  observer  direetion  added  veetorially 
to  the  average  solar  wind  speed.  For  simplieity,  it  is  assumed  that  the  solar  wind  is  moving 
radially  away  from  the  Sun  at  a  eonstant  speed.  In  a  flare  radial  direetion,  the  wave  speed  is 

V  =  B  R'^^^  +  Vsw  with  eonstant  B  =  Vd  Rd'^^. 

In  a  non  flare-radial  direetion  the  shape  faetor  is  involved  and  the  wave  speed  is 

Ve  =  f  B  R'^^^  +  Vsw  with  Ve  =  dR/dt, 

that  is  integrated  from  R  =  Rde  to  obtain  the  shoek’s  propagation  time  to  the  desired  radius  R. 

The  predieted  shoek  arrival  time  is  simply  the  sum  of  the  initial  Type  11  burst  time,  the  driven 
phase  duration  and  the  travel  time  of  the  disturbanee  through  the  interplanetary  medium.  As  the 
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blast  wave  loses  energy  during  its  propagation  through  the  interplanetary  medium,  the  shoek 
speed  deeays  to  the  magneto-aeoustie  speed.  The  program  eomputes  the  sonie  Maeh  number  and 
Alfven  speed  in  interplanetary  space,  using  simple  approximations  for  interplanetary  plasma 
density,  temperature  and  magnetic  field  as  a  function  of  distance  from  the  Sun,  and  derives  the 
magneto-acoustic  Mach  number  of  the  shock.  If  this  number  is  less  than  Mach  1  at  the  Earth  or 
other  selected  observation  point,  no  shock  is  predicted  to  arrive. 

The  STOA  documentation  and  associated  references  suggest  that  shocks  that  are  capable  of 
propagating  to  1  AU  are  likely  to  be  associated  with  “big  flares”.  The  criteria  for  identifying  a 
big  flare  are  not,  however,  clearly  established.  There  is  an  indication,  based  on  the  original  test¬ 
ing  of  the  program,  that  the  better  STOA  predictions  are  associated  with  “long  duration  soft  X- 
ray  events”.  This  means  a  decay  time  Td  of  one  hour  or  more,  together  with  a  velocity  Vd  equal 
or  greater  than  1000  km/s.  Other  diagnostics  of  shock  generation  and  propagation  into  the  solar 
corona  may  be  coronal  mass  ejection  information  and  forecaster  judgment. 

STOA  Inputs 

The  STOA  science  module  requires  the  following  inputs: 

Global  Parameters:  Year,  Day,  UT  (used  to  initialize  event  onset  and  end  times) 

Specify  Event  Duration:  The  user  can  choose  to  specify  either  the  Stop  Time  of  the  event,  the 

Duration  of  the  event,  or  have  the  event  duration  estimated  from  inputs  of 
the  associated  GOES  ?,oii  X-ray  Levels . 

Observer  Eocation:  The  observer  location  can  be  designated  as  Earth  or  the  user  can  Specify  a 
location.  The  latter  choice  prompts  the  user  to  enter  the  observer  distance 
{Obs.  Distance),  offset  angle  {Obs.  Offset  Angle),  and  name  {Obs.  Name) 
in  the  lowest  three  text  boxes  on  the  right  side  of  the  window  as  described 
below. 

Event  onset  time:  Time  of  onset  of  Type  II  radio  burst  from  USAE  RSTN  site  in  the  format 

MM/DDAfY  HH:MM.  Default  is  the  start  time  from  the  top  of  the 
environment  window. 

Event  end  time:  When  Stop  Time  is  selected  to  specify  the  event  duration,  the  user  enters 

the  event  end  time  in  the  format  MM/DDAfY  HH:MM.  The  end  time  of 
the  shock  driver  must  not  be  earlier  than  the  Type  II  event  onset  time.  The 
shock  driver  time  must  be  less  than  7  days  (168  hours).  Shock  driver 
durations  are  typically  a  fraction  of  a  day.  In  this  case,  GOES  satellite  X- 
ray  levels  are  not  used  to  estimate  the  event  duration. 

Event  duration:  When  Duration  is  selected  to  specify  event  duration  the  user  enters  the 

event  duration  in  hours.  The  shock  driver  time  must  be  <  7  days  (168 
hours).  Shock  driver  durations  are  typically  a  fraction  of  a  day.  In  this 
case,  GOES  satellite  X-ray  levels  are  not  used  to  estimate  the  event 
duration. 

Backg.  Class:  When  X-ray  Levels  is  selected  to  specify  the  event  duration,  the  user 

enters  the  background  X-ray  level  measured  by  the  1  -8  Angstrom  X-ray 
instrument  on  a  GOES  satellite  before  the  event  occurred.  This  value  is 
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entered  with  a  elassifieation  letter  and  a  numerie  field.  The  usual  X-ray 
event  elassifieation  letters  A,  B,  C,  M,  or  X  ean  be  used  with  the  numeric 
field  consisting  of  1-3  characters  which  may  be  digits  or  an  optional  deci¬ 
mal  point.  The  numeric  field  multiplies  the  flux  level.  The  range  of 
allowed  values  is  A1  through  X99. 

Peak  Class:  When  X-ray  Levels  is  selected  to  specify  the  event  duration,  the  user 

inputs  here  the  peak  X-ray  level  measured  by  the  1  -8  Angstrom  X-ray 
instrument  on  a  GOES  satellite  during  the  X-ray  event.  The  format  is  the 
standard  X-ray  event  classification  scheme  as  explained  above.  After 
entering  this  value  the  user  should  click  a  different  Specify  Event  Duration 
option  and  then  the  X-ray  Levels  choice  again  so  that  the  level  XN.N 
corresponding  to  1/2  log  of  the  peak  signal  will  be  displayed  next  to 
Decay  time  box. 

Decay  time,  level  XN.N:  When  A-ray  Levels  is  selected  to  specify  the  event  duration  the  user 

enters  the  time  in  the  format  MM/DD/YY  HH:MM  at  which  the  X-ray 
level  measured  by  the  1-8  Angstrom  X-ray  instrument  on  a  GOES  satellite 
during  the  X-ray  event  decays  to  the  level  XN.N.  The  level  XN.N  is 
calculated  from  the  Backg.  Class,  and  Peak.  Class.  Of  course,  this  time 
will  occur  after  the  peak  of  the  X-ray  event. 

Type  II  Speed(km/s):  The  Type  II  drift  speed  in  km/s  calculated  by  the  USAE  RSTN  network 
and  select  other  radio  telescope  sites  from  observations  of  Type  II  radio 
bursts.  This  value  must  be  greater  than  0  and  less  than  10000  km/s. 

Elare  lat  (deg  N):  The  solar  latitude,  between  +90°  and  -90°  North,  of  the  solar  flare 

associated  with  the  Type  II  radio  burst.  This  information  can  be  obtained 
from  H-alpha  observations  by  the  USAE  SOON  or  other  optical  sites  or 
from  X-ray  images.  Degrees  South  are  entered  as  negative  numbers. 

Elare  Ion  (deg  W):  The  solar  longitude,  between  +180°  and  -180°  West,  of  the  solar  flare 

associated  with  the  Type  II  radio  burst.  This  information  can  be  obtained 
from  H-alpha  observations  by  the  USAE  SOON  or  other  optical  sites  or 
from  X-ray  images.  Degrees  East  are  entered  as  negative  numbers. 
Eongitudes  greater  than  +/-  90°  from  the  direction  of  the  observer  may  not 
be  realistic. 

Solar  Wind  (km/s):  The  solar  wind  speed  must  be  positive  and  less  than  1000  km/s. 

Ohs.  Distance:  When  the  user  wishes  to  Specify  the  Observer  Location  they  enter  the 

observer  distance  in  AU.  It  must  be  greater  than  0.007  AU  and  less  than 
100  AU.  Note  that  observer  distances  less  than  0.2  AU  or  greater  than  50 
AU  are  unrealistic.  This  condition  is  not  detected  until  all  of  the  data  have 
been  entered  because  it  depends  on  several  data  entries. 

Obs.  Offset  Angle:  When  the  user  wishes  to  Specify  the  Observer  Location  they  enter  the 

observer  offset  angle  in  degrees.  It  is  the  offset  angle  from  the  Sun-Earth 
line,  from  -360°  to  +360°,  and  is  measured  in  the  ecliptic  plane,  in  the  same 
sense  as  the  longitude  of  the  solar  flare:  west  is  positive,  east  is  negative. 
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Obs.  Name: 


When  the  user  wishes  to  Specify  the  Observer  Location  they  enter  the 
observer  name  as  a  5  eharacter  alphanumerie  value.  If  this  field  is  left 
blank  STOA  uses  the  Earth  as  the  default  observer. 

Display  Text:  Cliek  the  Display  Text  button  to  display  the  text  window  if  it  was  elosed. 

STOA  Outputs 

STOA  returns  a  text  message  window  eontaining  the  results  of  the  model  ealculations  and  a 
summary  of  the  input  parameters.  The  model  outputs  are: 

•  Magneto-aeoustic  Mach  number  and  arrival  time  of  shock  at  observation  point 

•  Total  propagation  time  of  shock  in  hours  and  minutes 

•  Type  II  onset  time 

•  X-ray  or  other  event  end  time 

•  Driver  duration  time  in  hours 

•  Type  II  speed  in  km/s 

•  Solar  flare  latitude  and  longitude 

•  Solar  wind  speed 

•  Distance  from  Sun  to  observer  (e.g.,  Earth)  in  AU 
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The  TPM-1  Science  Module  (V2.5.1  Only) 

Model  Name:  Trapped  Proton  Model  (TPM-1) 

Version:  Version  1.2,  15  April  2003;  IGRF  updates  2009 

Developer:  S.  L.  Huston,  The  Boeing  Company;  IGRF  option  updates  by  AER,  Inc. 

References:  Huston,  S.L.,  Space  Environment  and  Effects:  Trapped  Proton  Model, 

NASA/CR-2002-2 11784,  NASA  Marshall  Spaceflight  Center  (2002) 

[see  $APGS_HOME\models\REPS\TPM.pdf] 

Huston,  S.E.,  and  K.A.  Pfitzer,  Space  Environment  Effects:  Low  Altitude 
Trapped  Proton  Model,  NASA/CR-1 998-208593,  NASA  Marshall 
Spaceflight  Center  (1998) 

Huston,  S.L,  G.A.  Kuck,  and  K.A.  Pfitzer,  Low  altitude  trapped  radiation 
model  using  TIROS/NOAA  data,  in  Radiation  Belts:  Models  and 
Standards,  J.E.  Lemaire,  D.  Heynderickx,  and  D.N.  Baker  (eds.). 
Geophysical  Monograph  97,  American  Geophysical  Union,  119  (1996) 

Meffert,  J.D.,  and  M.S.  Gussenhoven,  CRRESPRO  Documentation,  PL- 
TR-94-2218,  Phillips  Laboratory,  Hanscom  AEB,  MA  (1994),  ADA 
284578 

Olson,  W.P.,  and  K.A.  Pfitzer,  Magnetospheric  Magnetic  Eield  Modeling, 
Annual  Scientific  Report,  Air  Eorce  Office  of  Scientific  Research  contract 
P44620-75-C-0033,  McDonnell  Douglas  Astronautics  Co.,  Huntington 
Beach,  CA  (1977),  ADA  037492 

Note:  It  is  recommended  that  AE-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

TPM-1  Overview 

The  TPM-1  science  and  application  modules  are  based  on  the  Trapped  Proton  Model  (TPM) 
developed  by  Boeing  Corporation  for  the  NASA  Space  Environment  and  Effects  (SEE)  Program 
[Huston,  2002].  TPM  combines  both  the  Low  Altitude  Trapped  Radiation  Model  (LATRM) 
[Huston  et  al,  1998],  also  developed  by  Boeing  for  NASA/SEE,  and  the  Air  Eorce  Research 
Laboratory's  (AERL)  CRRESPRO  model  [Meffert  and  Gussenhoven,  1994]  covering  higher 
altitudes.  Prom  the  introduction  of  the  TPM-1  report  [Huston,  2002]: 

“This  new  model  [TPM-1]  combines  elements  of  LATRM  and  CRRESPRO  to  obtain  a 
model  which  covers  the  full  spatial  extent  of  the  trapped  proton  belts,  determines  the 
differential  proton  flux  over  the  range  of  1  to  100  MeV,  and  contains  a  solar  cycle 
variation  at  low  altitudes.” 

A  description  of  the  CRRESPRO  model  can  be  found  in  the  CRRESPRO  Science  Module 
section  of  this  manual.  The  LATRM  model  (also  known  as  the  NOAAPRO  model)  is  described 
in  the  LATRM  report  [Huston  and  Pfitzer,  1998]  as  follows: 

“Under  NASA's  Space  Environment  Effects  (SEE)  program,  the  Boeing  Company  has 
developed  a  new  model  for  the  low-altitude  trapped  proton  environment.  The  model  is 
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based  on  nearly  20  years  of  data  from  the  [Medium  Energy  Proton  and  Eleetron  Deteetor 
(MEPED),  a  eomponent  of  the  Spaee  Environment  Monitor  (SEM)  package  onboard  the] 
TIROS/NOAA  weather  satellites  [orbiting  at  840  km  and  93  degrees  inclination]. 

The  model,  which  we  have  designated  NOAAPRO  (for  NOAA  protons),  predicts  the 
integral  omni-directional  proton  flux  in  three  energy  ranges:  >16,  >36,  and  >80  MeV.  It 
contains  a  true  solar  cycle  variation  and  accounts  for  the  secular  variation  in  the  Earth's 
magnetic  field.  It  also  extends  to  lower  values  of  the  magnetic  L  parameter  than  does 
AP8.  Thus,  the  model  addresses  [some  of  the]  major  shortcomings  of  AP8  ... 

Eor  each  energy  channel,  the  model  data  are  organized  in  terms  of  L  and  5/finiin  (although 
these  parameters  are  mapped  into  coordinates  more  appropriate  to  the  data  space).  The 
model  consists  of  parameters  which  determine  the  absolute  magnitude  of  the  proton  flux, 
the  variation  of  the  proton  flux  with  the  solar  10.7  cm  radio  flux  (Eioj),  and  the  phase  lag 
between  F\oj  and  the  proton  flux.  This  approach  results  in  a  well-organized  data  set  for 
two  solar  cycles,  and  can  be  extended  into  the  future.” 

The  features  of  TPM- 1  are  further  summarized  in  the  conclusions  of  the  TPM-1  report: 

“The  development  of  TPM- 1  represents  a  significant  advance  in  the  field  of  trapped 
proton  modeling.  It  is  now  possible  to  predict  the  trapped  proton  flux  in  the  energy  range 
1-100  MeV  with  good  accuracy  over  several  solar  cycles.  TPM-1: 

•  Covers  the  geographic  region  from  approximately  300  km  to  geosynchronous 
orbit. 

•  Calculates  omni-directional  differential  flux  in  22  energy  channels  ranging  from 
1.5  to  81.5  MeV. 

•  Contains  a  continuous  variation  with  solar  activity,  valid  over  the  time  span  1960- 
2020.  The  solar  cycle  variation  is  driven  by  the  solar  10.7  cm  radio  flux  (P10.7). 

•  Contains  a  model  for  both  quiet  (nominal)  and  active  conditions,  e.g.,  after  an 
event  such  as  the  one  observed  by  CRRES  [in  which  a  new  belt  was  produced  by 
the  March  1991  interplanetary  shock  event]. 

•  Can  be  used  to  obtain  the  flux  at  a  particular  point  in  space  [TPM-1  Science 
Module],  or  combined  with  an  orbital  integration  to  obtain  orb  it- averaged  energy 
spectra  [TPM-1  Applications  Module]. 

At  low  altitudes,  TPM-1  tends  to  predict  harder  energy  spectra  than  does  the  previous 
AP-8  model  [see  NASAPRO  Science  Module  section  of  this  manual].  The  TPM-1 
flux  at  energies  above  about  10  MeV  is  higher  than  the  AP-8  predictions,  while  the 
reverse  is  true  below  10  MeV.  At  higher  altitudes,  the  shapes  of  the  TPM-1  and  AP-8 
spectra  are  similar.  Orbital  integrations  show  that  the  proton  flux  varies  over  the  solar 
cycle  by  a  factor  of  two  at  higher  energies,  with  the  variation  decreasing  as  the  energy 
decreases.” 

The  TPM-1  Science  Module  is  used  to  map  the  proton  flux  data  sets  used  by  TPM-1,  stored  in 
modified  magnetic  coordinates  [see  TPM-1  report],  onto  a  three-dimensional  spatial  grid 
specified  by  the  user.  The  mapping  is  accomplished  using  either  the  original  TPM-1  algorithms 
(which  uses  the  IGREXX  model,  where  XX  is  the  year,  mod  5,  closest  to  but  earlier  then  the  data 
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being  requested)  or  the  AFRL  algorithms  whieh  give  a  choiee  of  simpler  magnetic  field  models, 
e.g.  a  tilted/offset  dipole. 

After  selecting  a  proton  energy  and  magnetic  field  model,  the  module  calculates  the  modified 
magnetic  coordinates  for  each  user-specified  spatial  grid  point.  Resulting  flux  values  are  then 
obtained  from  interpolating  between  the  TPM-specified  modified  magnetic  grid  point  values  in 
the  TPM  data  files.  In  this  manner,  a  fully  three-dimensional  map  of  the  proton  flux  data  may  be 
obtained. 

Note:  Although  AF-GEOSpace  allows  the  data  to  be  mapped  in  three  dimensions  using 
a  variety  of  magnetic  field  models,  the  TPM-1  option  is  most  consistent  with  the 
reduction  of  the  original  data. 

TPM-1  Inputs 

The  TPM-1  Science  Module  requires  the  user  to  specify  the  following  information  to  determine 
which  data  set  to  use  and  which  magnetic  field  model  to  use  in  mapping  the  data. 

Energy  Channel  (MeV):The  energy  channel  parameter  selects  which  of  the  proton  flux  data  sets 

corresponding  to  the  twenty-two  energy  channels  between  1  and  100  MeV 
used  in  CRRESPRO  is  to  be  used  [see  CRRESPRO  Science  Module 
section  for  detailed  energy  channel  descriptions]. 

Mode:  Determines  whether  the  original  TPM-1  mapping  or  AERL  mapping  is 

used  to  go  between  spatial  and  magnetic  coordinates. 

TPM-1:  Uses  TPM-1  mapping 

AERE:  Uses  AERE  mapping.  If  selected,  then  the  user  must  pick  the 
magnetic  field  model  to  be  used.  Originally  and  as  presented  in  AE- 
GEOSpace  Version  2.1,  magnetic  field  models  IGRF85  and  IGRF85/0-P 
were  offered.  However,  after  including  time-dependent  IGRE  internal  field 
capabilities  covering  1945-2010,  the  cuxxqyA  B -Model  options  include. 

B-Model:  Dipole:  A  dipole  field 

Dipole-Tilt:  A  tilted  dipole  field 

Dip-Tilt-Off:  A  tilted-offset  dipole  field 

IGRE:  The  International  Geomagnetic  Reference  Eield  with  no  external 
contributions  (Extrapolation  beyond  2010). 

IGRF/O-P:  The  IGRF  internal  field  with  the  Olson  and  Pfitzer  (1977) 
static  model  to  represent  the  external  field. 

Activity:  The  activity  parameter  specifies  whether  the  Quiet  (obtained  before  the  24 

March  1991  storm)  ox  Active  (obtained  after  the  24  March  1991  storm) 
proton  flux  data  sets  are  to  be  used. 

E10.7  Plot:  Produces  a  plot  of  the  P10.7  data  associated  with  the  File  option  of  the 

FIO.  7  source  selection  (see  next  item). 

P10.7  Data:  Specifies  the  P10.7  data  source  used  for  calculation  of  the  TPM-1  solar 

cycle  variation. 
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TPM-1  File:  Use  the  file  supplied  with  the  original  distribution 

whieh  eontains  projeetions  of  F10.7  out  to  2020. 

Globals:  Use  the  global  parameter  set  within  AF-GEOSpaee. 

Note  that  if  Globals  is  seleeted  then  the  time  of 
execution  must  by  less  than  or  equal  to  the  time  of  the 
latest  update  of  the  Global  parameter  set. 


TPM-1  Outputs 

The  TPM-1  Science  Module  returns  a  3D  Gridded  Data  Set  of  the  omni-directional  proton  flux 
for  the  selected  energy  channel  and  activity  level  in  units  of  #/(cm  s  MeV). 
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The  WBMOD  Science  Module  (V2.5.1  Only) 

Model  Name:  Wide-Band  Model  (WBMOD) 

15.03  (08  July  2005) 

Northwest  Researeh  Assoeiates,  Defense  Nuelear  Agency,  and  Air  Force 
Research  Laboratory 

Cervera,  M.A.,  R.M. Thomas,  K.M.  Groves,  A.G.  Ramil,  and  Effendy, 
Validation  of  WBMOD  in  the  Southeast  Asian  region.  Radio  Science,  36, 
1559-1572  (2001) 

Secan,  J.A.,  and  R.M.  Bussey,  An  Improved  Model  of  High-Latitude  F- 
Region  Scintillation  (WBMOD  Version  13),  PL-TR-94-2254  (1994),  ADA 
288558 

Secan,  J.A.,  R.M.  Bussey,  E.J.  Fremouw,  and  Sa.  Basu,  An  Improved 
Model  of  Equatorial  Scintillation,  Radio  Sci.,  30,  607-617  (1995) 

Note:  It  is  recommended  that  AF-GEOSpace  users  read  and  understand  the  original 
model  documentation  and  descriptive  articles  before  using  the  models. 

WBMOD  Overview 

WBMOD  is  a  climatological  model  for  ionospheric  scintillation.  Because  WBMOD  is  a 
climatological  model,  it  is  best  suited  for  long-range  planning  and  engineering  studies.  It  is  not 
as  well  suited  for  daily  planning  or  operations.  WBMOD  specifies  S4,  95th  percentile  fades,  and 
other  scintillation  parameters  for  trans-ionospheric  radio-wave  propagation  paths  given:  a 
location  on  the  globe,  a  satellite  above  100  km  altitude,  an  RE  frequency  above  100  MHz,  and 
several  geophysical  activity  indices.  Please  note  that  the  previous  release,  AF-GEOSpace  V2.1, 
contained  WBMOD  Version  14.02  (31  December  2000). 

WBMOD  Inputs 

The  WBMOD  science  module  requires  the  following  inputs. 

Global  Parameters:  Day,  UT,  Kp,  and  SSN  (note:  Year,  El 0.7  and  Ap  are  not  used). 

Propagation:  Specifies  whether  1-Way  or  2-Way  propagation  effects  should  be 

calculated.  For  the  2-Way  option,  the  user  must  also  input  the  following, 

Up/Dn  Link  Corr:  The  correlation  between  up-link  and  down-link  signals. 

For  up/down  links  between  the  same  transmitter  and 
receiver,  this  parameter  should  be  set  to  1;  for  bi-static 
links  with  spatially  separated  receivers  set  it  to  0. 

In-situ  Vd:  F  region  plasma  drifts;  calculated  by  WBMOD  using  models  when  the 

Model  option  is  selected  or  specified  explicitly  by  the  user  when  the  Input 
option  is  selected.  When  the  Input  option  is  selected  the  user  must  specify 
the  following, 

Vd,  North  (m/s):  Northward  F  region  plasma  drift  in  meters/second. 


Version: 

Developer: 

References: 
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Vd,  East  (m/s):  Eastward  E  region  plasma  drift  in  meters/second. 

Vd,  Down  (m/s):  Downward  E  region  plasma  drift  in  meters/seeond. 

Step:  Option  to  step  (move)  the  reeeiver  (Rcvr)  or  the  transmitter  {Tran). 

Normally  the  transmitter  is  a  satellite  and  the  reeeiver  is  ground-based. 
Moving  the  reeeiver  or  satellite  maps  out  regions  of  seintillation.  We 
reeommend  that  the  user  use  the  step  reeeiver  mode  Rcvr.  This  mode  will 
produee  a  map  that  is  easiest  to  interpret. 

Note:  In  the  step  transmitter  mode,  Tran,  data  are  for  seintillation  on  the  ray-path  from 
the  satellite  to  the  reeeiver  and  plotted  at  the  sub-satellite  point.  This  display 
loeation  is  not  the  ionospheric  location  where  the  scintillation  occurred.  Similarly, 
for  the  step  receiver  mode,  Rcvr,  the  data  will  be  plotted  at  the  receiver  location, 
not  the  ionospheric  location  where  scintillation  occurred. 

EP  Boundary:  The  location  of  the  equatorward  boundary  of  auroral  precipitation  may  be 

calculated  by  WBMOD  in  the  following  ways, 

Eff.  Kp:  An  effective  Kp  calculated  explicitly  from  a  DMSP 

observation  of  the  equatorward  boundary  in  magnetic 
latitude  and  local  time  is  used.  If  selected,  the  following 
must  be  specified. 

Effective  Kp:  The  effective  Kp  derived  from  the 
equatorward  boundary  location  observed  by  a  DMSP 
SSJ/4  sensor  (different  from  the  Global  Parameter  Kp). 

Explicit:  EP  boundary  locations  are  specified  directly  by  the 

user.  If  selected,  the  following  must  be  specified, 

EP  Bndry  MEAT:  The  magnetic  latitude  of  an 
equatorward  boundary  crossing  observed  by  the  SSJ/4 
sensor  on  DMSP. 

EP  Bndry  ET:  The  local  time  of  an  equatorward 
boundary  crossing  observed  by  the  SSJ/4  sensor  on 
DMSP.  This  must  be  consistent  with  the  EP  Bndry 
MLAT entered  above. 

Use  Kp:  Kp  from  the  Global  Parameters  is  used. 

Output:  WBMOD  output  can  be  determined  by  two  different  calculation  methods. 

Percentile:  WBMOD  computes  the  S4  scintillation  index  and  other 

parameters  for  user  defined  climatological  percentile, 
i.e.,  level  of  disturbance.  If  selected,  the  following  must 
be  specified, 

Percentile(0. 0-1.0):  This  percentile  selects  the  level  of 
disturbance,  i.e.,  the  S4  that  corresponds  to  this 
percentile.  Typical  procedures  use  90th  percentile  (the 
10th  worst  disturbance  level). 
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Threshold:  WBMOD  computes  the  percentage  of  time  that  either 

the  S4  or  phase  index  exceeds  a  certain  threshold  value. 
If  selected,  the  following  must  be  specified, 

Thresh.  Param:  Either  the  S4  or  Phase  index  can  be 
selected  for  threshold  parameterization  (toggle). 

Threshold:  The  threshold  level  is  dimensionless  for  S4, 
ranging  from  0.0  to  1 .2,  and  is  in  radians  for  Phase. 

Trans.  Freq  (MHz):  Specifies  transmitter  frequency  for  scintillation  calculation  in  MHz. 

Trans.Alt  (km):  Specifies  altitude  of  transmitter  (satellite)  in  km. 

Fixed  End  Fat:  Geographic  latitude  in  degrees  of  transmitter  or  receiver,  depending  on 

which  is  fixed  as  specified  by  Step  option. 

Fixed  End  Eon:  Geographic  longitude  in  degrees  of  transmitter  or  receiver,  depending  on 

which  is  fixed  as  specified  by  Step  option. 

Phase  Stability  (s):  Fength  of  time  in  seconds  over  which  phase  stability  is  required  for 

operational  system.  For  communication  applications  this  parameter 
approaches  zero  and  is  not  critical.  For  applications  involving  coherent 
data  integration  (e.g.,  radar)  this  parameter  should  be  set  equal  to  the 
integration  period. 

Kp@Focal  Sunset:  The  value  of  Kp  at  the  time  of  last  sunset  at  the  ground-based  transmitter 

or  receiver  location.  If  a  value  of  -I  is  used,  the  program  defaults  to  the 
value  of  Kp  used  in  the  EP  Boundary  computation. 

WBMOD  Outputs 

The  WBMOD  science  module  returns  2D  Gridded  Data  Sets.  We  recommend  displaying  output 

in  2D  plots  using  the  COORD-SFICE  graphical  object.  AF-GEOSpace  will  then  display  a  spatial 

distribution  (map)  for  the  following  parameters: 

95%tile  FADE:  The  95th  percentile  fade  depth  of  the  signal  intensity  (decibels).  Don’t 

confuse  this  percentile  with  the  climatological  percentile  input  to 
WBMOD.  For  example,  if  the  user  selected  a  90th  percentile  climatology, 
then  this  output  represents  the  5th  most  severe  fade  on  the  1 0th  most 
disturbed  day.  Fades  are  plotted  as  positive  values. 

S4:  The  S4  scintillation  index,  a  normalized  standard  deviation  of  the  signal 

intensity  (dimensionless). 

STDDEV  PHASE:  The  standard  deviation  of  the  phase  (radians),  also  known  as  sigma-phi. 

STDDEV  FOG(I):  The  standard  deviation  of  the  log  of  the  intensity  (decibels). 

%Time:  The  percentage  of  time  that  S4  or  Phase  exceeds  a  specified  threshold 

level  for  given  conditions  (%).  This  parameter  is  meaningful  only  when 
the  model  has  been  run  in  Threshold  mode. 
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APPLICATION  MODULES 


Application  modules  provide  orbit  creation/prediction,  dataset  integration  along  orbits,  magnetic 
field  model  generation,  and  access  to  speeialized  ionospherie  ray-traeing,  graphics,  and 
scintillation  products.  The  application  modules  are  aecessed  through  the  applieation  manager  that 
beeomes  visible  when  the  Application  option  in  the  Module  pulldown  menu  is  activated.  The 
application  manager  eonsists  of  two  lists  -  Available  Modules  and  Active  Modules.  Available 
Modules  are  the  modules  that  are  eurrently  supported  by  AF-GEOSpaee.  Active  Modules  are 
modules  that  have  been  ereated  and  used  by  the  AF-GEOSpaee  user  during  the  eurrent  session. 

When  initially  aeeessed,  the  applieation  manager  will  show  a  list  of  applieations  under  Available 
Modules.  Since  no  applications  have  yet  been  ereated,  the  Active  Modules  list  will  be  empty. 

Currently,  the  following  applications  are  supported  by  AF-GEOSpaee: 

•  APEXRAD-APP:  Advaneed  Photovoltaie  and  Electronies  Experiments  (APEX)  radiation 
dose  model  calculates  expected  accumulated  yearly  dose  (in  units  of  rads  silicon/year)  for 
four  thicknesses  of  aluminum  shielding  during  four  levels  of  magnetic  activity.  Best  for 
orbits  with  apogees  less  than  2500  km  (see  the  CRRESRAD-APP  for  higher  altitudes). 

•  BFIELD-APP:  The  B-Field  applieation  allows  the  generation  of  datasets  representing  the 
magnetic  field  in  the  near-Earth  spaee  environment.  A  variety  of  internal  (dipole,  IGRF)  and 
external  [Olson  and  PJitzer  1977;  Hilmer  and  Voigt  1995;  Tsyganenko  1987;  Tsyganenko 
1989;  Tsyganenko  2002;  Tsyganenko  and  Sitnov  2005]  field  models  are  used  to  generate 
gridded  data  set,  field  lines,  and  fiux  tubes. 

•  BFOOTPRINT-APP:  Traees  geomagnetic  field-lines  from  single  user-specified  points 
(defined  in  either  geographie  or  magnetic  coordinates)  or  multiple  points  along  a  satellite 
orbital  track.  The  resulting  field-lines,  orbital  track,  and  list  of  footprint  locations  on  the 
Earth’s  surface  can  be  viewed. 

•  CRRESELE-APP:  Combined  Radiation  and  Release  Effects  Satellite  (CURES)  electron 
flux  model  specifies  the  loeation  and  intensity  of  eleetron  omnidireetional  fluenee  (integral 
and  differential)  over  the  energy  range  0.5-6. 6  MeV  for  a  range  of  geomagnetic  activity 
levels.  A  user-speeified  orbit  is  traced  through  the  electron  flux  models  to  provide  an 
estimate  of  electron  fluenee  received  by  the  satellite  under  a  wide  range  of  magnetospheric 
conditions. 

•  CRRESPRO-APP:  Combined  Radiation  and  Release  Effects  Satellite  (CRRES)  proton  flux 
model  caleulates  proton  omnidireetional  fluenee  (integral  and  differential)  over  the  range  1  to 
100  MeV  for  user  specified  orbits  and  quiet,  active,  or  average  geophysieal  aetivity  levels. 

•  CRRESRAD-APP:  Combined  Radiation  and  Release  Effects  Satellite  (CRRES)  space 
radiation  dose  model  calculates  expected  satellite  dose  aecumulation  behind  four  different 
thicknesses  of  aluminum  shielding  for  user-specified  orbits  for  aetive  or  quiet  geophysical 
activity  levels. 

•  lONSCINT-G-APP:  This  application  combines  the  GPS  scintillation  scenario  tools  of  the 
lONSCINT-G  Science  Module  with  the  orbital  ephemerides  of  individual  spaeecraft  to 
provide  a  time-series  of  S4  seintillation  index  values  for  each  platform-spacecraft  link. 
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LET-APP:  Calculates  the  linear  energy  transfer  (LET)  speetrum  and  its  assoeiated  single 
event  upset  (SEU)  rate  in  a  microelectronic  device  resulting  from  the  penetration  of  energetie 
spaee  particles.  Effects  from  both  cosmic  rays  and  the  trapped  protons  are  estimated  by  using 
the  CHIME  and  CRRESPRO  models  as  inputs. 

METEOR  IMPACT-APP:  Calculates  meteor  flux  or  damage  rates  for  given  eross  section, 
pit  depth,  and  material  type  as  a  function  of  time  along  a  user-specified  orbit.  Cumulative 
probabilities  for  flux  and  damage  rates  are  also  determined.  The  module  aecounts  for  meteor 
flux  variations  at  the  satellite  owing  to  both  position  ehanges  and  meteor  shower  and  storm 
temporal  variations. 

NASAELE-APP:  Calculates  eleetron  omni-directional  fluence  (differential  and  integral)  for 
ten  energy  intervals  in  the  range  0.65-5.75  MeV.  A  user-speeified  orbit  is  traced  through 
NASA  AE-8  trapped  electron  model  to  provide  an  estimate  of  eleetron  fluenee  received  by 
the  satellite  under  a  wide  range  of  magnetospheric  conditions. 

NASAPRO-APP:  Calculates  proton  omni-directional  fluence  (differential  and  integral)  over 
the  energy  range  1.5-81.3  MeV  for  user  speeified  orbits  and  quiet  or  active  geophysical 
conditions  using  the  NASA  AP-8  trapped  proton  model. 

RAYTRACE-APP:  Calculates  the  behavior  of  MHz  rays  in  an  ionosphere  specified  by  a 
Parameterized  Ionosphere  Model  (PIM)  data  set. 

SATEL-APP:  Calculates  orbital  trajectories  for  satellites  from  a  variety  of  user  specified 
orbital  element  input  sets.  Also  ealculates  properties  of  associated  satellite  detector  cones  and 
ground-to-satellite  links 

TPM-APP:  Eollowing  the  proeedures  established  for  CRRESPRO-APP,  this  application 
instead  uses  the  TPM-1  proton  flux  maps  to  calculate  proton  omni-direetional  fluence 
(integral  and  differential)  over  the  range  1  to  100  MeV  for  user  speeified  orbits  during 
periods  with  quiet,  aetive,  or  average  geophysieal  activity  levels. 

WBPROD-APP:  Gives  a  24hr  WBMOD  climatology  prediction  of  the  dB  fade  levels  due  to 
ionospheric  scintillation  effects  for  specific  ground-to-satellite  eommunication  links. 
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Running  Application  Modules 

To  run  an  application  module,  use  the  mouse  to  seleet  the  Applications  option  in  the  Module 
pulldown  menu  and  Available  Modules  and  Active  Modules  lists  will  appear  in  the  Environment 
Window.  Cliek  on  the  desired  ehoiee  under  Available  Modules.  For  example,  to  ereate  a  new 
version  of  CRRESELE-APP,  eliek  the  mouse  on  CRRESELE-APP  in  the  Available  Modules  list. 
Choosing  an  applieations  module  will  do  two  things:  first,  the  ehoiee  is  added  to  the  Active 
Modules  list;  seeond,  the  options  assoeiated  with  the  ehosen  applieation  module  will  appear  in 
the  Environment  Window.  In  general,  eaeh  applieation  module  will  have  a  different  Environment 
Window  representing  the  module  speeific  inputs.  Adjust  the  module  inputs  as  required.  Before 
aetually  running  the  module,  the  following  two  adjustments  might  be  eonsidered  whieh  ean 
effeet  run  time  and  the  size  of  the  output  files. 

First,  the  Grid  Tool  option  in  the  Edit  pulldown  menu  ean  be  used  to  modify  the  grid  to  be  filled 
with  data  using  the  seleeted  applieation  module. 

Seeond,  the  Dynamic  Tool  option  in  the  Edit  pulldown  menu  ean  be  used  to  adjust  both  the  time 
step  to  be  used  and  the  speeifie  output  parameters  to  be  ealeulated  if  a  Start  and  End  time  have 
been  set  at  the  top  of  the  window,  i.e.,  the  run  is  dynamie.  For  statie  runs  only  a  Start  time  is 
speeified  and  all  output  parameters  are  ealeulated  by  default. 

Finally,  the  Run/Update  option  in  the  Edit  pulldown  menu  is  used  to  run  or  re-run  the  module 
after  any  settings  have  been  ehanged.  When  the  module  run  is  eomplete  a  message  stating  that 
the  MODEL  IS  READY  AND  UP  TO  DATE  will  appear  in  the  Model  Status  box  at  the  bottom 
of  the  Environment  Window.  At  this  point,  the  data  produeed  are  ready  for  display  using 
graphieal  modules. 

Also,  the  Delete  option  in  the  Edit  pulldown  menu  is  used  to  remove  the  highlighted  applieation 
module  member  of  the  Active  Modules  list.  Note  that  all  aetive  graphies  objeets  must  be  removed 
before  the  applieation  module  used  to  generate  their  data  ean  be  removed. 
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The  APEXRAD-APP  Module 

APEXRAD 

15  September  1997;  IGRF  updates  2009 
Air  Force  Research  Faboratory 

Bell,  J.T.,  and  M.S.  Gussenhoven,  APFXRAD  Documentation,  PL-TR-97- 
2777(1997),  ADA  331633 

Gussenhoven,  M.S.,  F.G.  Mullen,  D.A.  Hardy,  D.  Madden,  F.  Holeman, 

D.  Delorey,  and  F.  Hanser,  Fow  Altitude  Fdge  of  the  Inner  Radiation  Belt: 
Dose  Models  from  the  APEX  Satellite,  IEEE  Trans.  Nucl.  Sci.,  42,  2035 
(1995) 

Gussenhoven,  M.S.,  F.G.  Mullen,  J.T.  Bell,  D.  Madden,  and  E.  Holeman, 
APEXRAD:  Fow  Altitude  Orbit  Dose  as  a  Function  of  Inclination, 
Magnetic  Activity  and  Solar  Cycle,  IEEE  Trans.  Nucl.  Sci.,  44,2\6\, 
(1997) 

Mullen,  E.G.,  M.S.  Gussenhoven,  J.T.  Bell,  D.  Madden,  E.  Holeman,  and 
D.  Delorey,  Fow  Altitude  Dose  Measurements  from  APEX,  CRRES,  and 
'DMS? ,  Advances  in  Space  Res.,  21,  1651,  (1997) 

Note:  It  is  recommended  that  AF-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

APEXRAD-APP  Overview 

The  APEXRAD  application  and  science  modules  are  based  on  the  PC  program  APEXRAD 
developed  and  released  by  the  Air  Force  Research  Faboratory.  More  information  can  be  found  in 
the  APEXRAD  Science  Module  section  of  this  document. 

The  APEXRAD-APP  module  calculates  satellite  radiation  dose  accumulations  behind  four 
different  thicknesses  of  aluminum  (either  slab  or  hemisphere)  for  user-specified  orbits.  Dose 
accumulation  is  predicted  using  empirical  dose  rate  models  created  from  data  measured  on  the 
Advanced  Photovoltaic  and  Electronics  Experiment  (APEX)  which  flew  in  a  362  x  2544  km 
elliptical  orbit  inclined  at  70  degrees.  These  dose  models  have  a  higher  position  resolution  at  low 
altitudes  than  the  previously  released  CRRESRAD  models.  The  APEXRAD  models  give  dose 
rates  averaged  over  the  entire  APEX  mission  and  for  four  different  levels  of  magnetic 
disturbance,  based  on  a  15  day  (offset  by  1  day)  running  average  of  the  linear  geomagnetic 
activity  index  Ap.  APEXRAD  is  best  applied  to  orbits  with  apogees  less  than  2500  km,  perigees 
greater  than  350  km,  inclinations  less  than  60  degrees  and  for  times  during  solar  cycle  minimum. 
It  can  be  useful  for  orbits  with  higher  inclinations  or  lower  perigees,  but  the  user  must  account 
for  any  dose  that  may  be  received  outside  the  region  covered  by  the  model.  For  higher  altitude 
orbits  the  use  of  CRRESRAD  is  recommended. 

Note:  The  APEXRAD  science  module  need  NOT  be  run  before  APEXRAD-APP. 


Model  Name: 
Version: 
Developer: 
References: 
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APEXRAD-APP  Inputs 

The  inputs  to  the  APEXRAD-APP  module  are  the  orbit  elements  needed  to  ealeulate  the  satellite 
orbit.  The  Environment  Window  for  the  APEXRAD-APP  module  is  the  same  as  that  for  the 
SATEE-APP  module  exeept  that  the  SMean  option  is  inaetive  and  APEXRAD-APP  is  set  to  use 
the  orbit  propagator  Eokangle.  See  the  SATEE-APP  Module  doeumentation  seetion  for  details. 
The  IGRF/O-P  magnetie  field  model  is  used  with  extrapolation  beyond  2010. 

APEXRAD-APP  Outputs 

The  APEXRAD-APP  module  generates  a  return  text  window.  Included  in  the  text  are  the  orbit 
elements  and  tables  of  the  accumulated  yearly  dose  (in  units  of  rads  silicon/yr)  for  all  four 
thicknesses  of  aluminum  shielding  during  four  levels  of  magnetic  activity.  Also  generated  is  a 
ID  Gridded  Data  Set  giving  the  position  of  the  satellite  as  a  function  of  time  that  can  be 
displayed  using  the  Satellite  graphics  module.  The  Show  Text  button  can  be  used  to  display  the 
text  window  if  it  has  been  closed. 
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The  BFIELD-APP  Module 


Model  Name: 
Version: 
Developer: 
Referenees: 


BFGEOS 
4  June  2008 

Air  Force  Research  Laboratory 

Hilmer,  R.V.,  and  G.-H.  Voigt,  A  Magnetospheric  Magnetic  Field  Model 
with  Flexible  Current  Systems  Driven  by  Independent  Physical 
Parameters,  J.  Geophys.  Res.,  100,  5613  (1995) 

Huang,  C.-L  .,  H.E.  Spence,  HJ.  Singer,  andN.A.  Tsyganenko,  A 
quantitative  assessment  of  empirical  magnetic  field  models  at 
geosynchronous  orbit  during  magnetic  storms,  J.  Geophys.  Res.,  113, 
A04208,  doi:10.1029/2007JA012623  (2008) 

Olson,  W.P.,  and  K.A.  Pfitzer,  A  Quantitative  Model  of  the 
Magnetospheric  Magnetic  Field,  J.  Geophys.  Res.,  79,  3739  (1974) 

Olson,  W.P.,  and  K.A.  Pfitzer,  Magnetospheric  Magnetic  Field  Modeling, 
Annual  Scientific  Report,  Air  Force  Office  of  Scientific  Research  contract 
F44620-75-C-0033,  McDonnell  Douglas  Astronautics  Co.,  Huntington 
Beach,  CA  (1977),  ADA  037492 

Pfitzer,  K.A.,  Improved  Models  of  the  Inner  and  Outer  Radiation  Belts, 
Scientific  Report  No.  1,  PL-TR-91-2187,  Phillips  Laboratory,  Hanscom 
AFB,  MA  (1991),  ADA  242579 

Qin,  Z.,  R.E.  Denton,  N.A.  Tsyganenko,  and  S.  Wolf,  Solar  wind 
parameters  for  magnetospheric  magnetic  field  modeling.  Space  Weather, 

5,  SI  1003,  doi:10:1029/2006SW000296  (2007) 

Tsyganenko,  N.A.,  Global  Quantitative  Models  of  the  Geomagnetic  Field 
in  the  Cislunar  Magnetosphere  for  Different  Disturbance  Levels,  Planet. 
Space  Set,  35,  1347-1358  (1987) 

Tsyganenko,  N.A.,  A  Magnetospheric  Magnetic  Field  Model  with  a 
Warped  Tail  Current  Sheet,  Planet.  Space  Sci.,  37,  5-20  (1989) 

Tsyganenko,  N.A.,  A  model  of  the  near  magnetosphere  with  a  dawn-dusk 
asymmetry,  1.  Mathematical  structure,  J.  Geophys.  Res.,  107  (AS),  1179, 
10.029/2001JA000219  (2002a) 

Tsyganenko,  N.A.,  A  model  of  the  near  magnetosphere  with  a  dawn-dusk 
asymmetry,  2.  Parameterization  and  fitting  to  observations,  J.  Geophys. 
Res.,  107  (AS),  1176,  10. 029/200 1JA000220  (2002b) 

Tsyganenko,  N.A.,  and  M.I.  Sitnov,  Modeling  the  dynamics  of  the  inner 
magnetosphere  during  strong  geomagnetic  storms,  J.  Geophys.  Res.,  110, 
A03208,  doi:  10.029/2004JA0 10798  (2005) 
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Note:  It  is  recommended  that  AF-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

BFIELD-APP  Overview 

The  B-Field  application  generates  maps  of  the  magnetic  field  in  the  near-Earth  space 
environment.  It  can  be  used  to  generate  gridded  data  sets  of  magnetic  field  magnitudes,  to  trace 
field  lines  and  to  construct  flux  tubes.  The  application  code  was  written  by  Robert  V.  Hilmer  of 
AFRE.  To  trace  magnetic  field-lines  originating  from  points  along  a  satellite  orbit  track,  the  user 
should  use  BFOOTPRINT-APP. 

B-FIELD  Inputs 

Inputs  to  the  BFIEED-APP  are  needed  to  specify  which  type  of  data  set  to  generate  and  which 
field  models  to  implement. 

The  Generate  section  specifies  the  data  sets  to  be  generated  when  the  B-FIELD  application  is 
run.  The  user  may  choose  any  combination  of  data  set  choices. 

Gridded  Data:  Choosing  this  option  generates  magnetic  field  GSM  components  and 

magnitude  at  each  point  on  the  grid  specified  under  the  Grid  Tool. 

MEAT  Field  Lines:  Choosing  this  option  generates  field  lines  emanating  from  constant 

(dipole)  magnetic  latitude.  The  user  specifies  the  magnetic  latitude, 
minimum  magnetic  local  time,  maximum  magnetic  local  time  (all  at  one 
Earth  radius),  and  the  number  of  local  time  steps  in  the  MEAT  Field  Line 
Inputs  section. 

MET  Field  Lines:  Choosing  this  option  generates  field  lines  starting  at  a  constant  magnetic 

local  time.  The  user  specifies  the  magnetic  local  time,  minimum  magnetic 
latitude,  maximum  magnetic  latitude  (all  at  one  Earth  radius)  and  the 
number  of  latitude  steps  in  the  MET  Field  Line  Inputs  section. 

Flux  Tube:  Choosing  this  option  generates  field  lines  representing  a  flux  tube.  The 

user  specifies  either  the  geographic  (latitude,  longitude,  altitude)  or 
magnetic  (MEAT,  MET,  Radius)  coordinates  of  the  center  of  the  footprint 
of  the  flux  tube,  a  diameter  and  the  number  of  field  lines  to  generate  in  the 
Flux  Tube  Inputs  section.  If  a  single  field  line  is  requested  or  the  diameter 
is  zero  then  a  single  field  line  is  constructed  anchored  at  the  footprint 
center.  Magnetic  dipole  coordinates  are  also  available. 

The  Internal  B-Field  section  allows  the  user  to  specify  which  model  to  use  for  the  Earth’s 
internal  magnetic  field.  The  options  are: 

Dipole:  An  Earth  centered  dipole  field  with  the  tilt  determined  by  UT,  Julian  day, 

and  year.  The  equatorial  surface  field  is  approximately  30750  nT. 

IGRF(  1945-20 10):  The  International  Geomagnetic  Reference  Field.  The  coefficient  set  is 

chosen  according  to  the  time  between  the  first  day  of  1945  and  the  last  day 
of  2010.  Code  source:  National  Space  Sciences  Data  Center  (NSSDC). 
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Fast  IGRF; 

A  computationally  faster  truncated  version  of  the  IGRF  field  developed  by 
Pfitzer  (1991).  The  typical  speed  advantage  is  7  to  8  times  while  the 

output  differs  from  that  of  the  full  IGRF  routine  by  no  more  than  0.1  nT. 

The  External  B-Field  section  allows  the  user  to  specify  which  model  to  use  for  external 
contributions  to  the  magnetic  field.  The  options  are; 

None:  No  external  field  model  is  used. 


Hilmer- Voigt: 

The  external  field  model  developed  by  Hilmer  and  Voigt  [1995]  is  applied. 
Choosing  this  option  requires  additional  inputs  to  be  specified  in  the 
Hilmer- Voigt  Options  window  that  appears  upon  selection. 

Olson-Pfitzer; 

The  external  field  model  developed  by  Olson  and  Pfitzer  [1977]  is 
applied. 

Tsyganenko  ‘89; 

The  external  field  model  developed  by  Tsyganenko  [1989]  is  applied. 

There  are  two  model  versions:  (1)  The  Kp  driven  model  uses  the  Kp  index 
from  the  Global  Parameters  section  of  the  Environments  window  and  (2) 
the  AE  driven  model  requires  an  AE  range  to  be  selected  from  the 
Tsyganenko  ‘89  Options  Window.  Code  source;  NSSDC. 

Tsyganenko  ‘87; 

The  external  field  model  developed  by  Tsyganenko  [1987]  is  applied  using 
the  “long”  warped  tail  with  no  aberration.  The  Kp  index  is  input  from  the 
Global  Parameters  section  of  the  Environment  Window. 

Code  source;  NSSDC. 

Tsyganenko  ’02 

The  external  field  model  developed  by  Tsyganenko  [2002a,  2002b]  is 
applied  (via  subroutine  TO  101  released  date  8  August  2001;  last  updated 
24  June  2006;  code  source;  httD://modelweb. gsfc.nasa.gov).  The  six  basic 
model  inputs  include  Dst,  IMF-By,  IMF-B^,  solar  wind  pressure  SW-Press 
(nPa),  and  the  coefficients  denoted  G1  and  G2.  There  are  three  methods 
for  generating  these  six  basic  input  parameters; 

Current  Dst  1-Hr  IME/SW  Trends:  In  this  option,  the  coefficients  G1  and 
G2  are  derived  from  a  I -hour  time  history  of  the  IME 
and  the  solar  wind  speed  SW-Vel  (km/s)  [Tsyganenko, 
2002a]. 

Read  current  values  from  VIRBO  file;  The  six  input  parameters  will  be 
read  from  file  solarwind.dat  located  in  the  directory 
$AEGS_HOME/models/data/BMODELS.  This  file 
currently  contains  values  for  1963  -  201 1  with  average 
values  listed  to  complete  the  remainder  of  2009. 
Parameter  updates  for  amending  this  file  are  available 
from  the  Virtual  Radiation  Belt  Observatory 
(httD://virbo.org).  The  parameters  included  here  were 
copied  from  a  file  called  “WGhour-v5.d”  found  in 
ftp  ://virbo . ora/OinDenton/hour/ meraed/W Ghour- v5  .d. zip .  After 
running  the  module,  a  status  variable  (equal  to  0,  1,  or 

2)  will  appear  in  parentheses  next  to  the  each  VIRBO 
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Tsyg-Sitnov  ’05 

parameter  read  from  file  solarwind.dat.  The  file  header 
provided  by  the  original  authors  explains  that  the  user 
should  “note  carefully:  If  the  status  variable  is  2,  the 
quantity  you  are  using  is  fairly  well  determined.  If  it  is 
1,  the  value  has  some  connection  to  measured  values, 
but  is  not  directly  measured.  These  values  are  still 
better  than  just  using  an  average  value,  but  not  as  good 
as  those  with  the  status  variable  equal  to  2.  If  the  status 
variable  is  0,  the  quantity  is  based  on  average 
quantities,  and  the  values  listed  are  no  better  than  an 
average  value.  The  lower  the  status  variable,  the  less 
confident  you  should  be  in  the  value.” 

Current  Dst,  IMF,  SW-Press,  GI,  G2:  In  this  option,  the  user  can  manually 
enter  the  six  basic  model  input  parameters. 

The  external  field  model  developed  by  Tsyganenko  and  Sitnov  [2005]  is 
applied  (via  subroutine  T04_s  released  date  25  March  2004;  last  updated 

24  June  2006;  code  source:  httD://modelweb. gsfc.nasa.gov).  The  ten  basic 
model  inputs  include  Dst,  IMF-By,  IMF-B^,  solar  wind  pressure  SW-Press 
(nPa),  and  the  coefficients  denoted  W1  -  W6.  There  are  three  methods  for 
generating  these  ten  basic  input  parameters: 

Current  Dst  Multi-Hr  IMF/S W  Trends:  In  this  option,  the  coefficients  Wl- 
W6  are  derived  from  a  multi-hour  time  history  of  the 
IMF  and  the  solar  wind  speed  SW-Vel  (km/s)  and 

-5 

density  SW Den  (#/cm  )  [Tsyganenko  and  Sitnov, 

2005]. 

Read  current  values  from  VIRBO  file:  The  ten  input  parameters  will  be 
read  from  file  solarwind.dat  located  in  the  directory 
$AFGS_HOME/models/data/BMODELS.  Eor  data  file 
details,  see  the  “Read  current  values  from  VIRBO  file” 
portion  of  the  Tsyganenko  ’02  section  above. 

Current  Dst,  IME,  SW-Press,  W1-W6:  In  this  option,  the  user  can 

manually  enter  the  ten  basic  model  input  parameters. 

The  MLAT  Field  Line  Inputs  section  allows  the  user  to  specify  the  parameters  needed  if  the 
MLAT Field  Lines  option  has  been  chosen.  The  inputs  required  to  specify  the  field  lines  are: 

MLAT :  The  constant  magnetic  latitude  (dipole)  specified  in  degrees  from  which  to 


METO,  MET  I: 

trace  field  lines. 

The  minimum  and  maximum  magnetic  local  times  specified  in  hours. 

Eield  lines  will  be  traced  at  magnetic  local  times  between  MLTO  and 

MLTl. 

Steps: 

The  number  of  field  lines  to  trace  {=  Steps+\).  This  specifies  the  number 
of  field  lines  to  trace  from  MLTO  to  MLTl.  Hence,  field  lines  will  be 
traced  at  MLT  =  MLTO  +  z  *  {MLTl  -  MLTO)  /  Steps  where  z  =  0  to  Steps 
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The  MLT  Field  Line  Inputs  section  allows  the  user  to  specify  the  parameters  needed  if  the  MLT 

Field  Lines  option  has  been  chosen.  The  inputs  required  to  specify  the  field  lines  are: 

MLT  The  constant  magnetic  local  time  specified  in  hours  from  which  to  trace 

field  lines. 

MLATO,  MLATl  The  minimum  and  maximum  magnetic  latitude  (dipole)  specified  in 

degrees.  Field  lines  will  be  traced  at  magnetic  latitudes  from  MLTO  to 
MLTl. 

Steps  The  number  of  field  lines  to  trace  (=  Steps+\).  This  specifies  the  number 

of  field  lines  to  trace  from  MLATO  to  MLATl.  Hence,  field  lines  will  be 
traced  at  MLAT  =  MLATO  +  i  *  {MLATl  -  MLATO)  /  Steps  where  /  =  0  to 
Steps 

The  Flux  Tube  Inputs  section  allows  the  user  to  specify  the  parameters  needed  if  the  Flux  Tube 

has  been  chosen.  Either  Geographic  or  Magnetic  coordinates  can  be  selected  by  clicking  the 

appropriate  button.  The  inputs  required  to  specify  the  flux  tube  are: 

Eat,  Eong,  Alt:  The  geographic  latitude,  longitude  and  altitude  of  the  center  of  the  flux 

tube.  Eatitude  and  Longitude  are  input  in  degrees.  Altitude  is  specified  in 
kilometers  above  the  Earth’s  surface. 

MEAT,  MET,  Rad:  The  magnetic  latitude,  local  time  and  geocentric  radius  of  the  center  of  the 

flux  tube.  MLAT  is  specified  in  degrees,  MLT  is  specified  in  hours,  and 
Rad  is  specified  in  Earth  radii. 

Diam:  The  diameter  of  the  flux  tube  specified  in  kilometers  for  geocentric 

coordinates  and  degrees  for  geomagnetic  coordinates.  The  edges  of  the 
flux  tube  are  specified  at  the  same  altitude(radius)  as  the  center.  If  Diam  = 
0  then  a  single  field  line  is  drawn  from  the  center  location. 

Steps:  The  number  of  field  lines  to  generate  to  represent  the  flux  tube.  The  field 

lines  will  be  traced  from  the  boundary  of  a  circle  with  diameter  Diam 
centered  at  Lat,  Long,  Alt.  If  Steps  =  I  then  a  single  field  line  is  drawn 
from  Eat,  Long,  Alt  ox  MLAT,  MLT,  Rad  location. 


Hilmer-Voigt  Inputs 

If  the  Hilmer-Voigt  External  Field  is  chosen,  a  popup  window  appears  requesting  further  inputs. 

Several  different  input  modes  are  available  for  the  Hilmer-Voigt  model, 

Kp  Only:  Eor  this  case,  only  the  Environment  window  global  Kp  is  used  to  drive  the 

model.  Note  that  the  Hilmer-Voigt  model  in  Kp  Only  mode  only  accepts 
Kp  as  an  integer  between  0  and  9.  AE-GEOSpace  will  automatically 
convert  the  global  Kp  to  an  integer  in  this  range.  The  value  used  will  be 
displayed  in  the  label  next  to  Kp  Only. 

Standoff,  Dst,  EquatorwardEdge:  The  user  must  choose  from  discrete  values  of  the  standoff 

distance,  the  Dst  value,  and  the  equatorward  edge  of  the  diffuse  aurora  at 
midnight.  Choosing  this  input  will  sensitize  the  inputs  at  the  right  side  of 
the  Hilmer-Voigt  ‘95  options  window. 
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Vacuum  Config:  For  the  vacuum  configuration,  the  standoff  input  box  will  be  sensitized. 

There  are  no  restrietions  for  standoff  distanee  (other  than  Standoff  >  0). 

Combinations  of  input  boxes  at  the  right  side  of  the  Hilmer- Voigt  ‘95  options  window  will  be 
available  aeeording  to  the  input  mode  setting.  These  boxes  allow  inputs  of  Dst,  Equator  Edge  of 
the  diffuse  aurora  at  midnight  and  standoff  distanee  to  be  selected.  Beeause  configurations 
representing  all  permutations  of  the  Hilmer-Voigt  input  options  do  not  exist  (many  are 
unphysical),  the  model  status  window  will  show  the  aetual  inputs  used.  If  the  parameters  listed  in 
the  status  window  differ  from  those  seleeted,  then  a  eonfiguration  substitution  oeeurred 
internally. 

Dst:  The  value  of  Dst  to  use  for  the  model.  Used  only  in  Standoff,  Dst, 

Equatorward  Edge  input  mode.  Only  diserete  values  of  Dst  are  allowed. 

Eq  Edge:  The  latitude  of  the  equatorward  edge  of  the  diffuse  aurora  at  midnight. 

Used  only  in  Standoff,  Dst,  Equatorward  Edge  input  mode.  Only  diserete 
values  of  equatorward  edge  are  allowed. 

Standoff:  The  magnetopause  standoff  distanee  is  speeified  in  Re.  This  input  is  used 

by  the  Vacuum  Config  and  Standoff,  Dst,  Equatorward  Edge  input  modes. 
If  in  Vacuum  Config.  mode,  then  arbitrary  values  for  the  standoff  distanee 
ean  be  introdueed  by  editing  the  text  box.  If  the  input  mode  is  Standoff, 
Dst,  Equatorward  Edge,  then  only  diserete  input  values  are  allowed. 

BFIELD-APP  Outputs 

Depending  on  the  Generate  options  seleeted,  the  BEIEED  application  will  produce  (1)  a  3D 
Gridded  Data  Set  of  the  GSM  eoordinates  and  magnitude  values  of  the  B-Eield,  (2)  a  field  fine 
Data  Set  eontaining  field  line  traees  from  a  constant  MEAT,  (3)  a  field  fine  Data  Set  eontaining 
field  line  traees  from  a  eonstant  MET,  and  (4)  a  field  fine  Data  Set  eontaining  field  line  traces 
representing  a  fiux  tube.  Outputs  (2),  (3),  and  (4)  are  displayed  using  the  field  fines  graphic 
module.  The  dipole  tilt  angle  is  also  ealeulated  and  appears  in  the  model  status  window. 
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The  BFOOTPRINT-APP  Module  (Static  Only) 

Model  Name:  BFGEOS  and  LOKANGL 

Version:  June  2008 

Developer:  Air  Force  Research  Laboratory 

References:  (See  the  BFIELD-APP  and  SATEL-APP  sections  of  this  document) 

Note:  It  is  recommended  that  AF-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

BFOOTPRINT-APP  Overview 

The  BFOOTPRINT  application  traces  geomagnetic  field-lines  from  single  user-specified  points 
or  from  multiple  points  from  along  a  satellite  orbital  track  and  determines  their  footprint 
locations  on  the  Earth’s  surface.  Magnetic  field  model  options  are  identical  to  those  offered  in 
the  BFIELD-APP  module.  Satellite  orbits  are  determined  using  the  LOKANGL  orbit  generator 
options  in  the  SATEL-APP  module. 

BFOOTPRINT  Inputs 

The  inputs  to  the  BFOOTRINT-APP  module  include  (1)  the  parameters  needed  to  specify  the 
geomagnetic  field  configuration  and  (2)  locations  from  which  to  trace  magnetic  field  lines,  i.e., 
either  single  user-specified  points  or  multiple  points  from  an  interval  of  a  satellite  orbit.  Access 
to  the  required  Setup  input  sections  is  controlled  by  the  Footprint  Model  and  Satellite  options  at 
the  top  of  the  Environment  Window.  The  BFOOTPRINT-APP  module  can  be  run  and/or  updated 
while  either  Setup  section  is  showing. 

The  Setup:  Footprint  Model  button  changes  the  lower  portion  of  the  Environment  Window  to 
show  Foot  Line  Input  and  B-Field  Parameter  options. 

Foot  Line  Input: 

Geographic:  Choosing  this  option  generates  a  field  line  through  a  single  Geographic 

Point  Coordinate.  The  user  specifies  the  point’s  Altitude  {Alt)  in  km, 
Latitude  {Lat)  in  degrees  North,  and  Longitude  {Lon)  in  degrees  East. 

Magnetic:  Choosing  this  option  generates  a  field  line  through  a  single  Magnetic 

Point  Coordinate.  The  user  specifies  the  point’s  geocentric  Radius  in 
Earth  Radii  (RE),  Magnetic  Latitude  {MLAT)  in  degrees  North,  and 
Magnetic  Local  Time  {MLT)  in  hours. 

From  Satellite:  Choosing  this  option  generates  field  lines  through  multiple  points  along  a 

satellite  orbit  interval  defined  by  the  following  Satellite  Orbit  Fractions 
and  Steps  options. 

Start  Frac:  The  first  trace  will  originate  from  the  satellite's  location 

at  time  =  \T_start  +  {Start  Frac){T_stop  -  T_start)), 
e.g..  Start  Frac  =  0.0  produces  a  trace  at  time  T_start. 
Permitted  value  is  from  0.0  and  1.0. 
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Stop  Frac: 


The  last  trace  will  originate  from  the  satellite's  location 
at  time  =  [T_start  +  {Stop  Frac){T_stop  -  T_start)'\,  e.g., 
Stop  Frac  =1.0  produces  a  trace  at  time  T  stop. 
Permitted  value  is  from  0.0  and  1.0. 

Steps:  The  number  of  field  lines  to  trace  (100  maximum). 

Traces  will  be  generated  from  orbit  locations 
corresponding  to  times  Start  Frac,  Stop  Frac,  and  at 
equal  time  intervals  between  the  two,  i.e.,  =  {T  stop  - 
T_start){Stop  Frac  -  Start  Frac)! {Steps  -  1).  If  Stop 
Frac  <  Start  Frac,  then  only  a  single  field  line  trace 
from  the  location  corresponding  to  Stop  Frac  will  be 
determined. 

Note:  If  this  From  Satellite  option  is  selected,  the  user  must  use  the  Setup: 
Satellite  option  at  the  top  of  the  Environment  Window  to  define  the  orbit. 
To  produce  traces  from  particular  points  along  an  orbit,  it  is  easiest  to  limit 
the  interval  using  the  orbit  T_start  and  T  stop  options  accessible  via 
Setup:  Satellite. 

B-Field  Parameters:  The  geomagnetic  field  configuration  is  a  combination  of  models 

representing  the  Internal  B-field  (i.e..  Centered  Dipole,  1GRF(1945-2010), 
or  Fast  IGRF)  and  External  B-field  (i.e..  None,  Hilmer-Voigt  ’95,  Olson- 
Pfitzer  ’77,  Tsyganenko  ’89,  ’87,  ’02,  and  Tsyg-Sitnov  ‘05).  Please  refer  to 
the  BFIELD-APP  Module  section  of  this  document  for  model  details. 

The  Setup:  Satellite  button  changes  the  lower  portion  of  the  Environment  Window  to  show  the 
standard  set  ol  Ephemeris  Data  inputs.  See  the  SATEL-APP  section  of  this  document  for  details. 
The  user  must  provide  either  orbital  elements  or  select  a  satellite  from  files  provided.  Note  that  if 
the  SGP4  propagator  is  used,  the  orbit  interval  must  be  within  a  year  of  T_ref  or  the  application 
will  issue  an  error  warning. 

Note:  This  is  a  Static  module,  i.e.,  the  global  time  is  used  to  establish  a  single  magnetic  field 
configuration.  If  field  lines  from  along  a  satellite  track  are  to  be  calculated,  higher  accuracy  will 
be  achieved  if  orbit  intervals  are  short  and  centered  about  the  global  time. 

BFOOTPRINT-APP  Outputs 

The  BFOOTPRINT  application  will  produce  a  Field  Fine  Data  Set  containing  a  field  line  trace 
through  a  single  user-specified  point  defined  in  geographic  or  magnetic  coordinates  or  field  line 
traces  from  points  (spaced  equally  in  time)  along  a  portion  of  a  satellite  orbit.  The  traces  are 
displayed  using  the  FIFED  FINE  graphics  module.  The  Show  Footprints  button  displays  a  list  of 
field-line  footprint  locations  on  the  Earth's  surface  given  in  Earth  Radii  {rad),  degrees  latitude 
{lat),  and  East  Eongitude  {Ion).  Footprints  determined  by  tracing  in  the  direction  parallel  (anti¬ 
parallel)  to  the  magnetic  field  are  labeled  FI  {F2).  Footprint  positions  of  field  lines  traces  that  do 
not  connect  to  the  Earth,  e.g.,  field  lines  map  beyond  the  boundary  of  the  magnetic  field  model, 
are  assigned  rad,  lat,  and  Ion  values  of  zero. 
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If  the  From  Satellite  option  is  used,  then  a  ID  Gridded  Data  Set  of  the  position  of  the  seleeted 
satellite  as  a  funetion  of  time  is  produced  that  can  be  viewed  using  the  SATELLITE  graphics 
module.  Single  user-specified  points  are  also  viewed  using  the  SATELLITE  graphics  module. 
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The  CRRESELE-APP  Module 


CRRESELE 

July  1995;  IGRF  updates  2009 
Air  Force  Research  Laboratory 

Brautigam,  D.H.,  and  J.  Bell,  CRRESELE  Documentation,  PL-TR-95- 
2128,  Phillips  Laboratory,  Hanscom  AFB,  MA  (1995),  ADA  301770 

Brautigam,  D.H.,  M.S.  Gussenhoven,  and  E.G.  Mullen,  Quasi-static 
Model  of  Outer  Zone  Electrons,  IEEE  Trans.  Nucl.  Sci.,  39,  1797-1803 
(1992) 

Note:  It  is  recommended  that  AF-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

CRRESELE-APP  Overview 

The  CRRESELE  science  and  application  modules  are  based  on  the  PC  program  CRRESELE 
developed  and  released  by  the  Air  Force  Research  Laboratory.  More  information  on  CRRESELE 
can  be  found  in  the  CRRESELE  Science  Module  section  of  this  document. 

The  CRRESELE-APP  module  determines  yearly  electron  omni-directional  fluence  (differential 
and  integral)  for  ten  energy  intervals  in  the  range  0.5-6.60  MeV.  A  user-specified  orbit  is  traced 
through  all  of  the  eight  different  CRRESELE  outer  zone  electron  flux  models  to  provide  an 
estimate  of  electron  fluence  received  by  the  satellite  under  a  wide  range  of  magnetospheric 
conditions.  The  differential  and  integral  omni-directional  fluences  are  calculated  from  the 
electron  flux  models  as  explained  by  this  excerpt  from  the  CRRESELE  documentation; 

“To  obtain  the  desired  yearly  differential  omni-directional  fluence  and  integral  omni¬ 
directional  fluence,  the  time  spent  in  each  spatial  bin  traversed  by  the  user-specified  orbit 
is  first  determined.  It  is  important  to  realize  that  only  those  spatial  bins  within  the  bounds 
of  the  model  (2.5  <=  L  <=  6.8  and  1  <=  B/BO  <=  684.6)  are  used  in  the  fluence 
calculation.  For  a  given  spatial  bin,  the  differential  omni-directional  fluence  [is  calculated 
as  the  differential  omni-directional  flux  multiplied  by  the  time  spent  in  the  bin]  and  the 
integral  omni-directional  fluence  for  a  given  energy  channel  [is  calculated  from  the 
product  of  the  differential  omni-directional  fluence  and  the  appropriate  energy 
bandwidths  by  summing  over  all  energy  channels  with  energy  greater  than  the  given 
channel].  [...]  The  final  reported  fluences  are  calculated  by  performing  the  summation 
over  all  traversed  bins  (within  the  model  bounds)  and  then  multiplying  by  [the  number  of 
days  in  1  year  divided  by  the  duration  of  the  orbit  trace  in  days].  [...]  The  percent  of  time 
spent  by  the  orbit  outside  the  model  bounds  is  provided  in  the  [output].  It  should  be 
stressed  again  that  the  calculated  fluences  are  from  the  outer  zone  electron  belt  only.  A 
low  Earth  polar  orbit  will  pass  within  the  model  bounds  only  about  15%  of  the  time, 
whereas  a  nearly  geosynchronous  orbit  will  remain  within  the  model  bounds  nearly  100% 
of  the  time.” 

Note:  The  CRRESELE  science  module  need  NOT  be  run  before  CRRESELE-APP. 


Model  Name: 
Version: 
Developer: 
References: 
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CRRESELE-APP  Inputs 

The  inputs  to  the  CRRESELE-APP  module  are  the  orbit  elements  needed  to  ealculate  the 
satellite  orbit.  The  Environment  Window  for  the  CRRESELE-APP  module  is  the  same  as  that  for 
the  SATEL-APP  applieation  except  it  is  set  to  use  the  orbit  propagator  Lokangle.  See  the 
SATEL-APP  Module  section  of  the  documentation  for  input  descriptions.  The  IGRF/O-P 
magnetic  field  model  is  used  with  extrapolation  beyond  2010. 

CRRESELE-APP  Outputs 

The  CRRESELE  application  generates  a  return  text  window  that  can  be  displayed  using  the 
Show  Text  button  if  it  was  closed.  Included  in  the  text  are  the  orbit  elements  and  tables  of  both 
the  differential  fiuence  (in  #/cm^-keV-yr)  and  integral  omni-directional  fluence  (in  #/cm^-yr) 
calculated  for  all  ten  energy  channels  and  all  eight  outer  zone  electron  flux  models.  Also 
generated  is  a  ID  Gridded  Data  Set  giving  the  position  of  the  satellite  as  a  function  of  time  that 
can  be  displayed  using  the  Satellite  graphics  module. 

Note  that  the  “Model  Number”  values  {0,  1,  2,  3,  4,  5,  6,  and  7)  reported  in  the  text  window 
correspond  to  the  eight  Api5  Model  Range  options  {5.0-7. 5,  7.5-10.0,  10.0-15.0,  15.0-20.0,  20.0- 
25.0,  25.0-55.0,  AVE,  and  MAX)  described  in  the  CURES  Science  Module  section,  respectively. 
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The  CRRESPRO-APP  Module 


Model  Name:  CRRESPRO 

Version:  28  July  1994;  IGRF  updates  2009 

Developer:  Air  Force  Research  Laboratory 

References:  Meffert,  J.D.,  and  M.S.  Gussenhoven,  CRRESPRO  Documentation,  PL- 

TR-94-2218,  Phillips  Laboratory,  Hanscom  AFB,  MA  (1994),  ADA 
284578 

Gussenhoven,  M.S.,  E.G.  Mullen,  M.D.  Violet,  C.  Hein,  J.  Bass,  and  D. 
Madden,  CRRES  High  Energy  Proton  Flux  Maps,  IEEE  Trans.  Nucl.  Sci., 
40,  1450-1457  (1993) 

Note:  It  is  recommended  that  AF-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

CRRESPRO-APP  Overview 

The  CRRESPRO  application  and  science  modules  are  based  on  the  PC  program  CRRESPRO 
developed  and  released  by  the  Air  Force  Research  Eaboratory.  More  information  on 
CRRESPRO  can  be  found  in  the  CRRESPRO  Science  Module  section  of  this  document.  Note 
that  the  TPM-l-APP  application  module  produces  results  similar  to  those  of  CRRESPRO-APP. 

The  CRRESPRO-APP  module  calculates  proton  omni-directional  fluence  (differential  and 
integral)  over  the  energy  range  1-100  MeV  for  user  specified  orbits  and  quiet  or  active 
geophysical  conditions.  Fluences  are  calculated  from  the  CRRES  proton  flux  maps  as  explained 
by  this  excerpt  from  the  CRRESPRO  Documentation: 

“To  calculate  differential  omni-directional  fluences  per  year  for  an  orbit  input  by  the  user, 
the  time  in  seconds  spent  in  each  (L,B/B0)  bin  is  calculated  [...]  and  the  differential  flux 
for  each  bin  is  multiplied  by  the  time  in  seconds  spent  in  that  bin.  The  figures  in  the 
individual  bins  are  then  summed  [and]  the  resulting  figure  is  then  multiplied  by  seconds 
per  year  divided  by  the  sum  of  time  in  seconds  for  all  bins  [including  the  time  the  orbit 
spends  outside  the  model  region].” 

Integral  omni-directional  fluence  for  a  given  energy  channel  is  calculated  from  the  differential 
omni-directional  fluence  by  summing  over  all  energy  channels  with  energy  greater  than  the 
given  channel  (eliminating  those  with  overlapping  energy  ranges,  channels  5  and  15)  and 
multiplying  by  appropriate  bandwidths,  as  discussed  in  the  CRRESPRO  documentation. 

Note:  The  CRRESPRO  science  module  need  NOT  be  run  before  CRRESPRO-APP. 

CRRESPRO-APP  Inputs 

The  inputs  to  the  CRRESPRO-APP  module  are  the  orbit  elements  needed  to  calculate  the 
satellite  orbit.  The  Environment  Window  for  the  CRRESPRO-APP  module  is  the  same  as  that 
for  the  SATEE-APP  application  except  CRRESPRO-APP  is  set  to  use  the  orbit  propagator 
Lokangle.  See  the  SATEL-APP  Module  section  of  the  documentation  for  input  descriptions.  The 
IGRF/O-P  magnetic  field  model  is  used  with  extrapolation  beyond  2010. 
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CRRESPRO-APP  Outputs 

The  CRRESPRO  application  module  generates  a  return  text  window  which  can  be  displayed 
using  the  Show  Text  button  if  it  has  been  closed.  Included  in  the  text  are  the  orbit  elements  and 
tables  of  both  the  differential  fluence  (in  #/cm^-MeV-yr)  and  integral  omni-directional  fluence 
(in  #/cm^-yr)  calculated  for  all  22  retained  energy  channels  and  for  both  active  and  quiet 
conditions.  Also  generated  is  a  ID  Gridded  Data  Set  giving  the  position  of  the  satellite  as  a 
function  of  time  that  can  be  displayed  using  the  Satellite  graphics  module. 
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The  CRRESRAD-APP  Module 


CRRESRAD 

6  August  1992;  IGRF  updates  2009 
Air  Force  Research  Laboratory 

Kearns,  K.J.,  M.S.  Gussenhoven,  CRRESRAD  Documentation,  PL-TR- 
92-2201,  Phillips  Laboratory,  Hanscom  AFB,  MA  (1992),  ADA  256673 

Gussenhoven,  M.S.,  E.G.  Mullen,  M.  Sperry,  KJ.  Kerns,  and  J.B.  Blake, 
The  Effect  of  the  March  1991  Storm  on  Accumulated  Dose  for  Selected 
Satellite  Orbits:  CRRES  Dose  Models,  IEEE  Trans.  Nuc.  Sci.,  29,  1765- 
1772  (1992) 

Gussenhoven,  M.S.,  E.G.  Mullen,  D.H.  Brautigam,  E.  Holeman,  C. 

Jordan,  F.  Hanser,  and  B.  Dichter,  Preliminary  Comparison  of  Dose 
Measurements  on  CRRES  to  NASA  Model  Predictions,  IEEE  Trans.  Nucl. 
Sci.,  38,  1655-1662  (1991) 

Note:  It  is  recommended  that  AF-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

CRRESRAD-APP  Overview 

The  CRRESRAD  application  and  science  modules  are  based  on  the  PC  program  CRRESRAD 
developed  and  released  by  the  Air  Force  Research  Laboratory.  More  information  can  be  found  in 
the  CRRESRAD  Science  Module  section  of  this  document. 

The  CRRESRAD-APP  module  calculates  expected  satellite  dose  accumulation  behind  four 
different  thicknesses  of  aluminum  shielding  for  user  specified  orbits  during  quiet,  active,  or 
average  geophysical  activity  levels.  Dose  accumulation  is  calculated  from  the  CRRES  dose  rate 
maps  for  each  of  the  four  shielding  domes  (82.5,  232.5,  457.5,  and  886.5  mils)  and  for  each  of 
the  two  dose  rate  detectors  (HILET  and  LOLET)  by  determining  the  time  in  seconds  that  a 
specified  orbit  stays  in  a  (L,  B)  coordinate  bin  and  multiplying  this  time  by  the  dose  rate  for  this 
bin.  These  figures  are  then  summed  over  the  bins  and  multiplied  by  the  number  of  seconds  in  a 
year  divided  by  the  sum  of  the  time  in  seconds  for  all  bins  (including  time  the  orbit  spends 
outside  the  model  region). 

Note:  The  CRRESRAD  science  module  need  NOT  be  run  before  CRRESRAD-APP. 

CRRESRAD-APP  Inputs 

The  inputs  to  the  CRRESRAD-APP  module  are  the  orbit  elements  needed  to  calculate  the 
satellite  orbit.  The  Environment  Window  for  the  CRRESRAD-APP  module  is  the  same  as  that 
for  the  SATEL-APP  module  except  CRRESRAD-APP  is  set  to  use  the  orbit  propagator 
Lokangle.  See  the  SATEL-APP  Module  documentation  section  for  details.  The  IGRF/O-P 
magnetic  field  model  is  used  with  extrapolation  beyond  2010. 


Model  Name: 
Version: 
Developer: 
References: 
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CRRESRAD-APP  Outputs 

The  CRRESRAD-APP  module  generates  a  return  text  window  that  ean  be  displayed  using  the 
Show  Text  button  if  it  has  been  elosed.  Ineluded  in  the  text  are  the  orbit  elements  and  tables  of 
the  aeeumulated  yearly  dose  (in  units  of  rads  silieon/yr)  for  all  four  shielding  domes  and  both 
deteetors.  Also  generated  is  a  ID  Gridded  Data  Set  giving  the  position  of  the  satellite  as  a 
funetion  of  time  that  ean  be  displayed  using  the  Satellite  graphies  module. 
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The  lONSCINT-G-APP  Module 


Model  Name:  GPS  Version  of  the  High  Fidelity  lonospherie  Seintillation  Simulation 

Algorithm  (lONSCINT-G) 

Version:  July  2009 

Developer:  AER,  Ine.,  Boston  College,  and  the  Air  Force  Research  Laboratory 

References:  (See  the  lONSCINT-G  Science  Module  section  of  this  document) 

Note:  It  is  recommended  that  AF-GEOSpace  users  read  and  understand  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 


lONSCINT-G-APP  Overview 

The  lONSCINT-G  Application  Module  generates  a  simulated  time-based  series  of  S4 
scintillation  values  representing  conditions  between  a  user-specified  platform  position  and  either 
a  satellite.  An  option  to  use  a  fixed  targeting  angle  (defined  in  azimuth  and  elevation  angle)  is 
also  provided.  The  lONSCINT-G-APP  simulation  options  are  identical  to  those  offered  in  the 
science  module  based  on  the  same  model  (see  complete  details  in  the  lONSCINT-G  Science 
Module  chapter).  Satellite  orbits  are  determined  using  the  LOKANGL  orbit  generator  options 
from  within  the  SATEL-APP  module. 


lONSCINT-G-APP  Inputs 

The  lONSCINT-G  Application  Module  requires  four  types  of  inputs  used  to  define  (1)  a  static 
run  time  or  dynamic  run  time  interval,  (2)  scintillation  database  options  to  characterize  the  type 
of  scenario  desired  along  with  a  large  random  number  seed  (typically  a  5 -digit  number),  (3)  the 
static  platform  position,  and  (4)  either  orbital  details  for  defining  the  platform-satellite  link  or  an 
azimuth/elevation  targeting  angle  for  defining  a  fixed  look  direction  from  the  specified  platform 
position.  Access  to  the  required  Setup  input  sections  is  controlled  by  the  Satellite  and  lonscint-G 
options  at  the  top  of  the  Environment  Window.  The  lONSCINT-G-APP  module  can  be  run 
and/or  updated  while  either  Setup  section  is  showing.  The  following  inputs  are  required. 

Global  Parameters:  Year,  Day,  LIT  (Kp,  SSN,  El 0.7,  and  Ap  are  not  used). 

The  Setup:  Satellite  button  changes  the  lower  portion  of  the  Environment  Window  to  show  the 
standard  set  of  Ephemeris  Data  inputs  and  is  fixed  to  use  the  LOKANGL  propagator.  See  the 
SATEL-APP  section  of  this  document  for  details.  In  Static  mode,  the  T_start  and  T  stop  values 
will  correspond  to  a  24-hour  interval  starting  from  the  Global  Start  time.  In  Dynamic  mode, 
those  same  values  will  reflect  the  user-specified  Global  Start  and  End  times  of  the  run.  The  S4 
scintillation  index  will  be  calculated  for  the  satellite-platform  link  at  intervals  specified  in  the 
Time  Step(s)  text  box. 

The  Setup:  lonscint-G  button  changes  the  lower  portion  of  the  Environment  Window  to  show 
lonscint-G  Model  Parameters  options  which  match  those  of  the  lONSCINT-G  Science  Module, 
namely 

Scintillation  Database  Options:  Scenarios  are  generated  from  the  scintillation  database  using  an 
input  solar  activity  level  and  four  related  selection  modifiers,  namely 
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Sunspot  Activity  Level;  Scintillation  scenarios  eorresponding  to  four 

different  levels  of  solar  activity  as  defined  by  sunspot 
number  (SSN)  are  represented.  It  should  be  noted  that 
no  signifieant  scintillation  at  GPS  frequencies  occurs  at 
solar  minimum  and  “worst  case”  scenarios  are 
assoeiated  with  maximum  SSN  values. 

1  =  Low  (10-30):  This  SSN  range  represents  solar 
minimum  conditions. 

2  =  Moderate  (50-75):  This  SSN  range  represents 
conditions  during  the  ramp  up  or  down  from  solar 
maximum. 

3  =  High  (85-100):  This  SSN  range  represents 
conditions  from  a  “low-activity”  maximum. 

4  =  Maximum  (100-120):  This  SSN  range  represents 
conditions  from  a  “high-activity”  maximum. 

Use  Seasonal  Climatology;  This  option  provides  the  most  realistic 
representation  of  the  seasonal  dependence  of 
scintillation  as  a  function  of  longitude.  If  the  occurrenee 
of  scintillation  is  desired  at  all  longitudes  regardless  of 
scintillation  season,  then  uncheck  this  option.  Note  that 
quiet  scintillation-free  nights  can  still  occur  even  with 
this  option  unchecked. 

Use  Only  Top  10%  Scintillation  Scenarios:  Selecting  this  option 

highlights  the  “worsf’  of  the  possible  scenarios,  i.e.,  it 
restriets  scenario  selection  to  be  made  randomly  from 
only  those  portions  of  the  database  representing  the  top 
10%  of  nights  based  on  the  total  time  of  aetive 
scintillation  per  night.  If  left  unchecked,  then  scenario 
sets  will  be  ehosen  randomly  from  all  in-season  nights 
for  the  chosen  solar  activity  level. 

Retain  Generated  Random  Number  Seed  Between  Runs:  Each  time  a  new 
lONSCINT-G  entry  appears  in  the  Active  Modules  list, 
e.g.,  ScilonScintgO,  a  new  random  number  is  placed  in 
the  text  box  to  the  right  of  the  next  input  line.  Eaeh  run 
utilizes  the  random  number  seed  that  is  visible  before 
the  run  is  made.  This  value  is  used  to  randomize  the 
selection  of  scenario  sets  from  the  appropriate  solar 
activity  level  section  of  the  database.  Eor  a  given  set  of 
activity  settings,  using  the  same  number  seed  will  eause 
the  same  scintillation  scenario  to  be  generated.  Select 
this  option  to  retain  use  of  the  random  number  seed  for 
additional  runs.  If  neither  this  nor  the  next  option  is 
checked,  then  a  Run/Update  will  place  a  new  random 
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number  seed  in  the  text  box  (to  be  used  for  the  next 
run!).  If  you  eomplete  a  run  without  eheeking  this 
option  and  did  not  reeord  the  number  seed,  you  ean 
reeover  the  value  used  in  your  last  run  from  file 
C:\TEMP\SciIonScintgiMONSCimG.OUT  (assuming 
default  serateh  direetory  C:\TEMP). 

Speeify  and  Retain  Random  Number  Seed:  Seleet  this  option  and  edit  the 
number  seed  value  in  the  text  box  to  retain  use  of  the 
number  seed  for  the  eurrent  and  future  runs.  Using  the 
same  input  seed  will  eause  the  same  seintillation 
seenario  to  be  generated.  To  recreate  the  same  scenario 
for  more  than  one  Platform  Position,  perform  additional 
lONSCINT-G  Science  Module  runs  using  the  same 
Random  Number  Seed  for  each  platform  location. 

Platform  Position:  The  Platform  Position  defines  the  fixed  reference  position  used  for  all 

GPS  scintillation  scenario  calculations.  Note  that  there  will  be  no 
scintillation  directly  overhead  (i.e.,  at  the  center  of  the  skymap  viewed 
with  the  lONSCINT-G  graphic  module)  if  the  platform  is  placed  at  a 
magnetic  latitude  poleward  of  30  degrees.  The  location  is  input  in 
geographic  coordinates  assuming  a  spherical  Earth,  namely 

Eatitude:  The  platform’s  North  latitude  in  degrees. 

Eongitude:  The  platform’s  East  longitude  in  degrees  (±360°). 

Altitude  (km):  The  platform’s  altitude  in  kilometers  above  the 

Earth’s  surface. 


Use  Eixed  Targeting  Angles:  This  option  causes  the  module  to  display  scintillation  output  for  a 

fixed  location  in  the  sky  as  viewed  from  the  Platform  Position  defined 
above.  Note  that  a  satellite  selection  must  still  be  made  as  the  timing 
inputs  {T_start,  T  stop,  and  Time  Step(s))  from  the  Setup:  Satellite  settings 
are  still  required.  Any  arbitrary  satellite  may  be  used  for  this  purpose,  but 
note  that  the  “name”  to  appear  in  plots  comes  from  the  Sat  Name  field  in 
the  Setup: Satellite  settings  so  to  eliminate  confusion  it  should  be  edited  to 
read  something  appropriate  like  “Platforml”. 

Azimuth(Deg):  Azimuth  angle  in  degrees  as  measured  from  the 

Platform  Position  (0°  is  North,  90°  is  East,  etc.). 

Elevation(Deg):  Elevation  angle  in  degrees  as  measured  from  the 
Platform  Position  (90°  is  zenith). 

Notes:  The  File  menu  Save  Model/Open  Model  features  work  only  when  either  the  Retain 
Generated  Random  Number  Seed  Between  Runs  or  the  Specify  and  Retain  Random 
Number  Seed  option  has  been  used. 
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lONSCINT-G-APP  Outputs 

The  lONSCINT-G-APP  module  generates  a  time  series  of  the  S4  scintillation  index  representing 
the  changing  environment  between  the  platform  position  and  either  a  satellite  or  fixed  GPS  target 
location.  The  S4  index,  with  values  ranging  from  0.0  to  1.0,  is  a  dimensionless  quantity 
representing  the  normalized  standard  deviation  of  the  signal  intensity.  The  scintillation  index 
{S4Index),  azimuth  and  elevation  angles,  and  local  time  in  hours  (LocalTimeHrs)  can  be  plotted 
as  a  function  of  time  in  a  ID  window  by  using  the  Orbit  Probe  graphics  module.  A  tabulated 
version  of  the  output  can  be  found  in  file  C:\TEMP\AppIonScintg#\/OA5'C/ArG.(9f/r  (assuming 
default  scratch  directory  C:\TEMP).  If  the  Platform  Position  is  displayed  in  a  3D  window  using 
the  Station  graphics  module  when  tracking  a  satellite,  then  the  Satellite  and  Link  graphics 
modules  can  be  used  to  better  visualize  when  a  satellite  is  viewable  from  the  specified  platform. 
Note  that  use  of  the  Station  graphics  module  for  this  situation  will  require  converting  the 
platform  altitude  units  from  kilometers  to  Earth  radii,  i.e.,  Alt(Re)  1.0  +  Alt(km)/6370. 

Hint:  To  establish  a  context  for  interpreting  the  S4  scintillation  time  profiles  generated  for  a 
given  platform-satellite  link  using  this  module,  the  user  should  also  run  the  lONSCINT-G 
Science  Module  for  the  same  time  period  using  the  same  fixed  Platform  Position  and 
Scintillation  Database  Options  settings. 
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The  LET-APP  Module 


Model  Name:  CRRES/SPACERAD  Heavy  Ion  Model  of  the  Environment  (CHIME)  and 

CRRESPRO 

Version:  3.5  (Deeember  1995) 

Developer:  Eoekheed  Martin  Advaneed  Teehnology  Center  and  AFRL,  adapted  to 

AF-GEOSpaee  by  Radex,  Ine.  (now  AER,  Ine.) 

Referenees:  Chenette,  D.L.,  J.D.  Tobin,  S.P.  Geller,  CRRES/SPACERAD  Heavy  Ion 

Model  of  the  Environment,  CHIME,  PL-TR-95-2152,  Phillips  Eaboratory, 
Hanseom  AFB,  MA  (1995)  (User’s  guide  for  Version  3.5),  ADA  321996 

Chenette,  D.L.,  J.  Chen,  E.  Clayton,  T.G.  Guzik,  J.P.  Wefel,  M.  Garcia- 
Munoz,  C.  Lopate,  K.R.  Pyle,  K.P.  Ray,  E.G.  Mullen,  D.A.  Hardy,  The 
CRRES/SPACRAD  Heavy  Ion  Model  of  the  Environment  (CHIME)  for 
Cosmie  Ray  and  Solar  Partiele  Effeets  on  Eleetronic  and  Biologieal 
Systems  in  Spaee,  IEEE  Trans.  Nucl.  Sci.,  41,  2332-2339  (1994) 

Feynman,  J.,  G.  Spitale,  J.  Wang,  and  S.  Gabriel,  Interplanetary  Proton 
Fluenee  Model:  JPL  1991,  J.  Geophys.  Res.,  98,  13281  (1993) 

Meffert,  J.D.,  and  M.S.  Gussenhoven,  CRRESPRO  Doeumentation,  PL- 
TR-94-2218,  Phillips  Laboratory,  Hanseom  AFB,  MA  (1994),  ADA 
284578 

Note:  It  is  reeommended  that  AF-GEOSpaee  users  read  the  original  model 
doeumentation  and  descriptive  articles  before  using  the  models. 

LET-APP  Overview 

The  Linear  Energy  Transfer  (LET)  Application  Module  and  CURES  Heavy  Ion  Model  of  the 
near-Earth  Space  Environment  (CHIME)  Science  Module  are  based  on  the  PC  program  CHIME 
(with  modifications)  developed  and  released  under  the  auspices  of  the  Air  Force  Research 
Laboratory.  More  information  on  CHIME  can  be  found  in  the  CHIME  Science  Module  section 
of  this  document. 

The  LET-APP  Module  calculates  the  LET  spectra  and  associated  Single-particle  Event  Upset 
(SEU)  rate  in  an  electronic  device  for  a  user-specified  location  or  orbit.  In  addition  to  the 
Galactic  Cosmic  Rays  (GCR),  Anomalous  Component  (AC),  and  Solar  Energetic  Particles  (SEP) 
modeled  in  the  original  CHIME,  AF-GEOSpace  provides  the  capability  to  include  trapped 
protons,  as  specified  by  the  CRRESPRO  model  (see  the  CRRESPRO  Science  Module  section  of 
this  document),  in  the  calculation  of  LET  spectra  and  SEU  rates.  The  importance  of  the  LET 
spectra  and  method  of  determination  are  described  as  follows  in  the  CHIME  User’s  Manual: 

“For  the  purposes  of  estimating  single-particle  upset  effects  (including  latchup),  the 
heavy  ion  flux  distributions  as  a  function  of  particle  type  and  energy  are  transformed  into 
distributions  as  a  function  of  the  ion’s  linear  energy  transfer  (LET).  The  LET  is  the 
energy  lost  by  an  ion  and  deposited  into  the  target  material  per  unit  distance  along  the 
ion’s  path.  LET  generally  increases  with  the  atomic  number  of  the  ion  (Z)  and  generally 
decreases  with  increasing  velocity  (V)  approximately  as  (except  at  low  and  high 
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velocities  where  atomic  effects  and  relativistic  effects,  respectively,  become  important). 

Thus  a  faster  iron  ion  and  a  slower  oxygen  ion  can  have  the  same  LET  and,  by 
assumption,  the  same  ability  to  produce  a  single  event  upset  in  a  specific  device.  The 
LET  spectrum  is  a  convenient  way  to  integrate  and  keep  track  of  the  contributions  of  the 
various  ion  species  and  energies,  ordered  according  to  LET.” 

“The  LET  spectrum  calculator  in  CHIME  employs  an  integral  method  and  a  two-part 
(shield  and  target)  spherical  geometry  model.  The  thickness  of  the  shield  and  the  target 
are  specified  by  the  user  in  one  of  several  column  density  units:  milligrams  per  square 
centimeters  (mg  cm'^),  mils  of  aluminum  equivalent,  or  microns  of  silicon.  Since  the 
range  of  an  ion  depends  on  the  density  of  the  target  and  only  weakly  on  the  target 
composition,  the  mass  density  option  (mg  cm'^)  permits  the  model  to  be  used  with 
different  materials,  e.g.,  GaAs. 

Working  from  the  sensitive  region  out,  and  for  each  ion  species,  minimum  and  maximum 
incident  ion  energies  are  calculated  corresponding  to  pre-defined  LET  thresholds.  At  each 
threshold  LET,  the  integral  LET  spectrum  is  calculated  by  integrating  the  heavy  ion  flux 
spectrum  over  this  energy  range  and  summing  over  all  particle  species.  The  method  and 
its  results  have  been  described  in  greater  detail  by  Chennette  et  al.  (1994).” 

The  LET  spectrum  is  calculated  both  for  the  interplanetary  flux  environment  model  and  for  the 
near-Earth  flux  distribution,  shielded  by  the  effects  of  the  Earth  and  its  magnetic  field.  Eor  the 
GCR,  AC,  and  SEP,  the  interplanetary  LET  spectra  will  always  be  a  “worst  case”  in  terms  of 
energy  deposition.  If  the  trapped  proton  option  is  selected,  both  the  interplanetary  and  shielded 
LET  spectra  are  modified  to  include  the  trapped  proton  fluxes  corresponding  to  the  user- 
specified  orbit  or  location.  To  compute  the  geomagnetic  ally  shielded  fluxes  used  in  the  LET 
calculation,  a  geomagnetic  filter  function  is  computed  (see  CHIME  Science  Module)  for  either 
the  user-specified  location  or  as  an  average  over  a  user-specified  orbit.  This  filter  function  is  then 
applied  to  the  GCR,  AC,  and  SEP  particle  spectra  used  in  the  LET  spectra  computation.  Eor  the 
trapped  protons,  the  LET  spectrum  is  calculated  separately  at  each  point  along  an  orbit  and  then 
averaged  before  being  added  to  the  total  LET  spectra  (the  limiting  case  is  a  single  point  if  a 
location  is  specified). 

The  method  for  determining  SEU  rates  is  described  in  the  CHIME  User’s  Manual  as  follows: 

“To  calculate  a  single -particle  upset  rate,  CHIME  combines  the  LET  spectrum,  calculated 
as  described  above,  together  with  user  specifications  or  measurements  of  the  upset  cross 
section,  and  a  model  for  the  geometry  for  a  specific  device,  and  performs  a  numerical 
integration.  This  procedure  incorporates  a  rectangular  parallelepiped  model  like  that  of 
Pickel  and  Blandford  [IEEE  Trans.  Nuc.  Sci.,  NS-27,  1006,  1980]  to  estimate  the 
geomagnetic  factor  of  the  sensitive  region  as  a  function  of  path  length.  It  provides  a  way 
to  allow  the  user  to  input  a  measured  upset  cross-section  (as  a  function  of  LET)  as  an 
improvement  on  the  “step  function”  approximation.  The  only  restriction  on  this 
tabulation  is  that  it  must  be  mono  tonic  non-decreasing  with  increasing  LET.  This  method 
and  its  sensitivity  to  assumptions  of  the  geometry  model  have  been  described  by  Shoga  et 
al.  [IEEE  Trans.  Nuc.  Sci.,  NS-34,  1256,  1987].  It  is  a  direct  application  of  a  few  simple 
geometrical  concepts.” 
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“The  upset  rate  is  determined  as  the  rate  at  which  energetic  heavy  ions  in  the  space 
radiation  environment  can  deposit  more  than  a  certain  minimum  amount  of  energy  into  a 
specific  volume.  The  minimum  energy  deposit  required  to  cause  an  upset  is  called  the 
upset  threshold.  The  specific  volume  is  the  sensitive  volume  of  a  cell  in  the  device.  The 
single-particle  upset  rate  is  determined  from  the  product  of  the  local  particle  flux  or 
fluence  and  the  geometrical  factor  presented  by  the  sensitive  volume.” 

In  LET-APP  the  parameters  of  the  on-board  microelectronic  device  can  be  specified  in  the 
window  or  read  from  a  device  file.  The  user  is  urged  to  consult  the  CHIME  User’s  Manual  for 
more  details  of  the  SEU  rate  calculation  and  required  formats  for  the  device  input  files. 

Note;  The  CHIME  Science  Module  need  NOT  be  run  before  the  EET-APP  module. 

LET-APP  Inputs 

Input  to  the  EET-APP  application  comprises  the  inputs  required  to  run  the  CHIME  model,  as 
adapted  from  the  PC  version.  Several  methods  for  inputting  variables  are  available.  The  input 
window  is  logically  divided  into  three  areas:  an  environment  specification  section,  a  satellite 
location  and/or  microelectronic  device  section,  and  an  auxiliary  section  for  controlling  module 
output. 

Specify  Environment: 

GCR/AC  Elux:  Several  methods  for  generating  cosmic  ray  fluxes  (Galactic  Cosmic 

Rays/ Anomalous  Component  Spectra)  are  provided.  The  options  are: 

Off:  No  cosmic  ray  fluxes  generated. 

Modulation:  CHIME  provides  fluxes  corresponding  to  the  Level 

(entered  in  the  text  box,  approximate  range:  400  to 
1600  megavolts)  of  solar  modulation  selected  from  a 
full  range  of  monthly  values  over  the  period  1970-2010. 

Period:  CHIME  computes  the  average  of  the  fluxes  for  each  ion 

species  over  the  user-specified  time  interval  entered  in 
the  Year  1,  Day  1,  Year  2,  and  Day  2  text  boxes 
activated  when  this  option  is  selected.  Tabulated 
monthly  values  of  the  solar  modulation  parameter  for 
the  period  1970-2010  are  used. 

SEP  Event:  The  CHIME  model  provides  several  models  for  specifying  the  flux  or 

fluence  of  heavy  ions  originating  at  the  Sun  as  a  result  of  solar  energetic 

particle  (SEP)  events.  The  options  are; 

Off:  No  SEP  event  related  fiux/fiuence  is  generated. 

March  91  Peak:  Model  based  on  peak  CRRES  measurements  from  the 
March  1991  event 

June  91  Peak;  Model  based  on  peak  CRRES  measurements  from  the 
June  1991  event 
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March  91  Ave:  Model  based  on  average  CRRES  measurements  from 
the  Mareh  1991  event 

June  91  Ave:  Model  based  on  average  CRRES  measurements  from 

the  June  1991  event 

JPL  1991  Model:  Models  based  on  statistieal  distributions  of  solar  proton 
event  intensities  (JPL  1991,  Feynmann  et  al,  [1993]).  It 
provides  the  proton  fluenee  that  would  be  exeeeded  at  a 
probability  level  of  oeeurrenee  {Pr),  or  eonfidenee 
level,  from  50%  to  0.1%.  If  the  Flux  Inputs  option  Off 
or  Period  is  seleeted  above,  then  fluxes  are  ealeulated 
from  the  fluenees  using  the  user-speeified  time  interval. 
If  Modulation  is  seleeted  as  the  GCR/AC  Flux  option, 
then  a  random  period  of  1  year  is  used. 

Atomie  Z:  Two  ranges  for  the  ion  speeies  atomie  number  are  offered,  the  full  range 

{1  to  92)  or  a  redueed  range  {1  to  30)  may  be  used  to  save  ealeulation 
time.  If  the  full  range  is  speeified,  the  eode  uses  tabulated  values  for 
hydrogen  (Z=l)  to  niekel  (Z=28)  and  all  ions  heavier  than  niekel  are 
modeled  using  abundanee  ratios  to  iron. 

Note:  The  eosmie  ray  flux  input  and  solar  event  options  are  identieal  to  those  used  in  the 
CHIME  Seienee  Module. 

Trapped  Protons:  Two  models  of  trapped  protons  in  the  radiation  belts  eorresponding  to  a 

quiet  and  aetive  period,  CRRESPRO  Quiet  and  Active,  are  available  (see 
CRRESPRO  Doeumentation).  The  CRRESPRO  flux  data  are  read  in  for 
all  available  energies  and  ineorporated  into  the  CHIME  system,  using  the 
same  LET  and  SEU  algorithms  as  for  the  eosmie  ray  protons. 

Satellite/Deviee:  There  is  a  single  row  of  options  for  seleeting  the  satellite  loeation  and  another 

for  speeifying  the  deviee. 

Sat.  Loeation:  Input  the  satellite  loeation  as  a  single  point  or  speeify  an  orbit: 

Single  Point:  The  pop-up  menu  for  the  Single  Point  option  asks  for 

the  satellite’s  altitude  (km),  latitude  (degrees),  and 
longitude  (degrees). 

Orbit:  While  not  dynamie  LET-APP  permits  the  entry  of 

satellite  orbits  as  input.  The  orbit  elements  ean  be  of 
two  types: 

Mean  elements:  These  are  the  same  as  the  elements 
that  are  normally  read  in  by  the 
SATEL-APP  module,  exeept  there 
are  no  derivative  or  drag  terms. 

Chime  elements:  These  simple  elements  represent  the 
original  inputs  to  the  CHIME 
propagator  and  eonsist  of  the  above 
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Mean  elements,  except  that  the  mean 
anomaly  is  fixed  at  zero,  so  the 
reference  time  becomes  the  time  of 
perigee,  and  the  eccentricity  and 
mean  motion  are  replaced  by 
altitudes  for  apogee  and  perigee. 

Entering  a  set  of  Mean  elements  and  then  selecting  the 
Chime  elements  toggle  effects  a  translation  to  Chime 
elements.  The  Default  button  sets  default  orbit  element 
values  taken  ixom  Meffert  and  Gussenhoven  [1994]. 

Note:  The  CHIME  simple  elements  are  listed  as  those  parameters  differing  from  the  mean 

elements  (right  column)  and  those  in  common  with  the  mean  elements  (left,  highlighted). 
If  entering  Mean  elements,  one  must  convert  to  CHIME  elements  (by  selecting  the  Chime 
elements  toggle)  before  running  because  the  CHIME  propagator  uses  only  the  CHIME 
simple  elements.  A  run  error  will  occur  if  either  (1)  the  orbit  interval  designated  by 
T_start  and  T_stop  is  not  within  ±  1  year  of  T_ref  or  (2)  more  than  approximately  3000 
steps  are  calculated,  e.g.,  running  for  more  than  ~3.47  days  at  100  seconds  per  step. 

Erom  Eile:  The  From  File  button  enables  one  to  read  in  an  input 

file  containing  mean  orbital  elements,  in  analogy  to  the 
SATEE-APP  module.  The  mean  elements  are 
automatically  converted  to  the  equivalent  simple 
elements  for  use  by  the  CHIME  propagator.  The 
Update  button  ensures  that  the  start,  stop  times  and 
intervals  are  up  to  date.  The  Orbit  popup  window  is 
automatically  updated  to  show  the  parameters  that  were 
read.  Note  that  a  run  error  will  occur  if  the  orbit  interval 
designated  by  T_start  and  T  stop  is  not  within  ±  1  year 
of  the  reference  time  listed  next  to  the  satellite  name  in 
the  Chime  Satellite  Eile  Options  popup  window. 

SEU  Device:  The  on-board  microelectronic  device  can  be  specified  by  individual 

parameters  or  from  a  device  file: 

Parameters:  The  pop-up  menu  sets  the  device  parameters  as  required 

for  a  single  energy  deposit  SEU  calculation.  They 
include  EET  Threshold,  Upset  cross-section,  number  of 
Bits  per  device,  sensitive  region  dimensions  (X  and  Y 
are  transverse,  Z  is  depth)  and  Density  of  material.  The 
Default  button  sets  default  parameter  values  taken  from 
Meffert  and  Gussenhoven  [1994]. 

Erom  Eile:  The  pop-up  presents  a  file  selection  menu.  Elies  listed 

(in  $AEGS_HOME\models\data\CHIME\devices)  are 
those  that  came  with  the  PC  distribution.  They  contain 
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detailed  upset  eross-seetions  versus  LET,  for  input  into 
the  ealeulation  of  integrated  SEU  rates. 

Thiekness:  The  pop-up  menu  sets  the  Shield  and  Target  thieknesses.  The  units  for 

eaeh  ean  be  toggled  between  three  ehoices:  mg/cm\  mils  Al,  or  microns  Si. 
The  Default  button  sets  default  thiekness  values  from  Meffert  and 
Gussenhoven  [1994], 

Eet  Params;  The  pop-up  menu  sets  minimum  (LET MIN),  maximum  {LET MAX),  and 

number  of  points  (MEETS)  for  the  EET  spectrum.  The  Default  button  sets 
default  spectrum  parameter  values  from  Meffert  and  Gussenhoven  [1994]. 

LET-APP  Outputs 

The  EET  application  outputs  a  summary  text  file  for  the  selected  case.  The  text  file  may  be 
accessed  by  three  toggle  options.  Eor  each  option,  hit  the  Display  Text  button  to  update  and 
display  the  current  window: 

SEU:  Shows  the  final  SEU  rate  for  the  case.  The  results  are  presented  in  two 

forms:  a  “worst  case”  which  has  the  geometrically  unshielded  cosmic  ray 
and/or  solar  flare  rate  (wo  Bgeo)  along  with  any  trapped  proton 
contributions  and  a  “best  case”  which  is  the  same  except  that 
geometrically  shielded  cosmic/solar  particles  (w  Bgeo)  are  used.  If  the 
trapped  protons  are  not  included,  then  the  rates  should  be  the  same  as  for 
the  original  PC  version  (there  called  interplanetary  and  geomagnetic  ally 
shielded  rates). 

EET :  This  describes  the  two  EET  spectra  that  are  used  as  input  to  the  SEU  rate 

calculation.  The  two  flux  columns  represent  the  “worst/best”  case  results. 

EET/TRAPPED:  This  contains  the  original  PC  version  cosmic  ray  and/or  solar  flare  EET 

geometrically  unshielded  and  shielded  components,  and  in  a  separate 
column,  the  trapped  proton  EET  contribution. 

Options  SEU  and  LET  above  are,  with  some  minor  changes,  the  same  as  the  output  printed  by  the 
PC  version  of  CHIME  in  the  .SEU  and  .EET  files. 

Hit  the  Display  Text  button  to  update  and  display  the  current  text  window. 

EET-APP  outputs  a  ID  plot  of  the  EET  spectrum  (see  above)  in  the  form  of  a  log-log  function, 
for  the  selected  case.  Hit  the  Display  Plot  button  to  display  the  ID  plot.  If  inputs  are  changed  and 
the  module  is  rerun,  then  the  labels  in  the  plot  can  be  updated  by  again  using  the  Display  Plot 
button.  The  EET  spectrum  represents  the  total  flux  of  particles  of  all  types  with  an  energy 
deposit  per  thickness  (MeV/mg/cm^)  larger  than  the  threshold  for  the  bin.  The  two  data  lines 
represent  the  “worst/besf  ’  case  EET  results,  as  described  above.  Note  that  if  the  JPE  solar  flare 
model  is  chosen,  flux  is  replaced  by  fiuence. 

The  Plot  Options  button  provides  a  menu  for  modifying  the  X  and  Y  axes  of  the  ID  plot. 

The  EET  application  also  outputs  a  ID  Gridded  Data  Set  of  the  position  of  the  satellite  as  a 
function  of  time  that  can  be  displayed  using  the  Satellite  graphics  module.  The  orbits  can  be 
single  points  or  a  complete  trajectory,  as  calculated  by  the  CHIME  propagator. 
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The  METEOR  IMPACT-APP  Module 


Model  Name:  Meteor  Impaet  Map  Model 

Version:  February  2004 

Developer:  Radex,  Ine.  (now  AER,  Ine.)  and  the  Air  Force  Research  Laboratory 

References:  (see  reference  lists  in  the  manual  sections  entitled  “The  METEOR 

IMPACT  MAP  Science  Module”  and  “The  SATEL-APP  Module”) 

Note:  It  is  recommended  that  AF-GEOSpace  users  read  and  understand  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

METEOR  IMPACT-APP  Overview 

The  METEOR  IMPACT  application  module  is  based  on  the  Meteor  Impact  Map  Model.  More 
information  on  the  model  can  be  found  in  the  METEOR  IMPACT  MAP  Science  Module  section 
of  this  document.  If  used  in  dynamic  mode,  the  METEOR  IMPACT  MAP  Science  Module  can 
certainly  be  used  in  combination  with  SATEL-APP  to  provide  a  rough  measure  of  the  hourly 
meteor  impact  rate  along  a  satellite  orbit,  but  the  procedure  is  very  inefficient.  To  increase  both 
efficiency  and  accuracy,  METEOR  IMPACT-APP  was  developed  to  calculate  the  same  impact 
parameter  as  a  function  of  time  only  along  a  user-specified  orbit.  This  feature  enables  the  user  to 
see  meteor  flux  variations  at  the  satellite  owing  to  both  position  changes,  e.g.,  observed  fluxes 
decrease  when  blocked  by  the  Earth,  and  shower  and  storm  temporal  variations.  This  application 
also  calculates  the  probabilities  of  a  satellite  being  damaged  by  meteor  shower  particle  impacts 
over  a  period  of  time. 

Note:  The  METEOR  IMPACT  MAP  science  module  need  NOT  be  run  before  METEOR 
IMPACT-APP. 

METEOR  IMPACT-APP  Inputs 

The  inputs  to  the  METEOR  IMPACT-APP  module  include  both  the  orbit  elements  needed  to 
calculate  the  satellite  orbit  and  the  parameters  needed  to  specify  concurrent  meteor  showers  and 
storms.  While  the  meteor  impact  portion  of  the  application  will  run  using  the  default  settings,  the 
user  must  provide  orbital  elements  or  select  a  satellite  from  file  for  a  successful  run.  Access  to 
the  two  groups  of  inputs  is  provided  in  the  Setup  section  at  the  top  of  the  user  interface,  namely 

Satellite:  The  Satellite  button  changes  the  lower  portion  of  the  Environment 

Window  to  show  the  standard  set  ofEphemeris  Data  inputs.  See  the 
SATEL-APP  section  of  this  document  for  details.  The  user  must  provide 
either  orbital  elements  or  select  a  satellite  from  files  provided.  Note  that  if 
the  SGP4  propagator  is  used,  the  orbit  interval  must  be  within  a  year  of 
T_ref  or  the  application  will  issue  an  error  warning. 

Meteor  Impact  Model:  The  Meteor  Impact  Model  button  changes  the  lower  portion  of  the 

Environment  Window  to  show  meteor  shower  and  storm  input  options 
identical  to  those  described  in  the  METEOR  IMPACT  MAP  Science 
Module  section  of  this  document. 
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METEOR  IMPACT-APP  Outputs 

The  METEOR  IMPACT  application  module  returns  a  ID  Gridded  Data  Set  representing  the 
position  of  the  satellite  and  the  hourly  impact  rate  and  cumulative  probability  of  being  impacted 
by  a  meteor.  To  view  the  impact  rate  or  probability  output  as  a  function  of  time  in  a  ID  graphics 
window,  for  example,  use  the  ORBIT  PROBE  graphics  module  and  select  the  Path/Abscissa 
button  option  AppMeteorImpact:  Time  and  the  Data/Ordinate  button  options  AppMeteor Impact: 
Hourly  Impact  or  CumProb. 
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The  NASAELE-APP  Module 

NASA  Trapped  Electron  Model  AE-8 

National  Space  Science  Data  Center  (NSSDC)  Data  Set  PT-1  IB,  Oct 
1987;  IGRE  updates  2009 

NASA/NSSDC  (distributed  in  AE-GEOSpace  with  permission) 

Vette,  J.I.,  The  AE-8  Trapped  Electron  Model  Environment, 
NSSDC/WDC-A-RS  91-24  (1991) 

Vette,  J.I.,  The  NASA/National  Space  Science  Data  Center  Trapped 
Radiation  Environment  Model  Program  (1964-1991),  NSSDC/WDC-A-RS 
91-29(1991) 

Jordan,  C.E.,  NASA  Radiation  Belt  Models  AP-8  and  AE-8,  GL-TR-89- 
0267,  Geophysics  Eaboratory,  Hanscom  AEB,  MA  (1989),  ADA  223660 

Note:  It  is  recommended  that  AE-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

NASAELE-APP  Overview 

The  NASAEEE-APP  module  determines  yearly  electron  omni-directional  fluence  (differential 
and  integral)  for  ten  energy  intervals  in  the  range  0.65-5.75  MeV.  A  user-specified  orbit  is  traced 
through  the  two  different  NASAEEE  outer  zone  electron  flux  models  (min  and  max),  at  each 
energy,  to  provide  an  estimate  of  electron  fluence  received  by  the  satellite  under  a  wide  range  of 
magnetospheric  conditions.  The  differential  and  integral  omni-directional  fiuences  are  calculated 
using  the  same  method  employed  by  the  CRRESEEE-APP  module. 

Note:  The  NASAEEE  science  module  need  NOT  be  run  before  NASAEEE-APP. 

NASAELE-APP  Inputs 

The  inputs  to  the  NASAELE-APP  module  are  the  orbit  elements  needed  to  calculate  the  satellite 
orbit.  The  Environment  Window  for  the  NASAELE-APP  module  is  the  same  as  that  for  the 
SATEL-APP  application  except  NASAELE-APP  is  set  to  use  the  orbit  propagator  Lokangle.  See 
the  SATEL-APP  Module  section  of  the  documentation  for  input  descriptions.  The  IGRE/O-P 
magnetic  field  model  is  used  with  extrapolation  beyond  2010. 

NASAELE-APP  Outputs 

The  NASAEEE  application  generates  a  return  text  window  that  can  be  displayed  using  the  Show 
Text  button  if  it  was  closed.  Included  in  the  text  are  the  orbit  elements  and  tables  of  both  the 
differential  and  integral  omni-directional  fluence  (in  units  of  #/(cm  keV  yr)  and  #/(cm  yr), 
respectively)  calculated  for  all  ten  energy  channels  and  two  outer  zone  electron  flux  models. 

Also  generated  is  a  ID  Gridded  Data  Set  giving  the  position  of  the  satellite  as  a  function  of  time 
that  can  be  displayed  using  the  Satellite  graphics  module. 


Model  Name: 
Version: 

Developer: 

References: 
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The  NASAPRO-APP  Module 

NASA  Trapped  Proton  Model  AP-8 

National  Spaee  Seience  Data  Center  (NSSDC)  Data  Set  PT-1  IB,  Oct 
1987;  IGRF  updates  2009 

NASA/NSSDC  (distributed  in  AF-GEOSpace  with  permission) 

Vette,  J.I.,  The  AE-8  Trapped  Electron  Model  Environment, 
NSSDC/WDC-A-RS  91-24  (1991) 

Vette,  J.I.,  The  NASA/National  Space  Science  Data  Center  Trapped 
Radiation  Environment  Model  Program  (1964-1991),  NSSDC/WDC-A-RS 
91-29(1991) 

Jordan,  C.E.,  NASA  Radiation  Belt  Models  AP-8  and  AE-8,  GL-TR-89- 
0267,  Geophysics  Eaboratory,  Hanscom  AEB,  MA  (1989),  ADA  223660 

Note:  It  is  recommended  that  AE-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

NASAPRO-APP  Overview 

The  NASAPRO-APP  module  calculates  yearly  proton  omni-directional  fluence  (differential  and 
integral)  over  the  energy  range  1.5-81.3  MeV  for  user  specified  orbits  and  through  two  different 
NASAPRO  flux  models  (AP-8  min  and  max).  Eluences  are  calculated  from  the  NASA  proton 
flux  maps  using  the  same  method  employed  by  the  CRRESPRO-APP  module.  Integral  omni¬ 
directional  fluence  for  a  given  energy  channel  is  calculated  from  the  differential  omni-directional 
fluence  by  summing  over  all  energy  channels  with  energy  greater  than  the  given  channel  and 
multiplying  by  appropriate  bandwidths. 

Note:  The  NASAPRO  science  module  need  NOT  be  run  before  NASAPRO-APP. 

NASAPRO-APP  Inputs 

The  inputs  to  the  NASAPRO-APP  module  are  the  orbit  elements  needed  to  calculate  the  satellite 
orbit  and  the  Environment  Window  is  the  same  as  that  for  the  SATEE-APP  application  except 
NASAPRO-APP  is  set  to  use  the  orbit  propagator  Eokangle.  See  the  SATEE-APP  Module 
section  of  the  documentation  for  input  descriptions.  The  IGRE/O-P  magnetic  field  model  is  used 
with  extrapolation  beyond  2010. 

NASAPRO-APP  Outputs 

The  NASAPRO  application  module  generates  a  return  text  window  which  can  be  displayed 
using  the  Show  Text  button  if  it  has  been  closed.  Included  in  the  text  are  the  orbit  elements  and 
tables  of  both  the  differential  and  integral  omni-directional  fluences  (in  units  of  #/(cm^MeV  yr) 
and  #/(crW  yr),  respectively)  calculated  for  all  22  energy  channels  and  for  both  active  and  quiet 
conditions.  Also  generated  is  a  ID  Gridded  Data  Set  giving  the  position  of  the  satellite  as  a 
function  of  time  that  can  be  displayed  using  the  Satellite  graphics  module. 
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The  RAYTRACE-APP  Module 


RAYTRACE 
November  2001 

Radex,  Inc.  (now  AER,  Inc.)  and  Air  Eorce  Research  Eaboratory 

Coleman,  C.J.,  A  General  Purpose  Ionosphere  Ray  Tracing  Procedure, 
Report  SRLOl 31 TR,  Defence  Science  and  Technology  Organization, 
Australia  (1993) 

Daniell,  R.E.,  Jr.,  E.D.  Brown,  D.N.  Anderson,  M.W.  Pox,  P.H.  Doherty, 
D.T.  Decker,  J.J.  Sojka,  and  R.W.  Schunk,  Parameterized  Ionospheric 
Model:  A  Global  Ionospheric  Parameterization  Based  on  Pirst  Principles 
Models,  RaJzo  30,  1499-1510(1995) 

Jones,  R.M.,  and  J.J.  Stephenson,  A  Versatile  Three-Dimensional  Ray 
Tracing  Computer  Program  for  Radio  Waves  in  the  Ionosphere,  OT 
Report  75-76,  US  Govt.  Printing  Office,  Washington,  DC  20402  (1975) 

Note:  It  is  recommended  that  AP-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

Overview 

Ray  tracing  allows  the  user  to  plot  the  behavior  of  rays  in  an  ionosphere  specified  by  a  PIM  data 
set.  The  PIM  science  module  must  be  run  before  the  ray  tracing  application  can  be  used.  When 
PIM  is  run  in  dynamic  mode,  this  application  will  perform  the  same  ray  trace  calculations  for 
each  time  frame  of  the  dynamic  PIM  output  using  a  fixed  set  of  transmitter  coordinates  and 
frequency/elevation  properties.  Transmitter  coordinates  and  selected  ray  frequency  and  elevation 
ranges  are  submitted  to  the  Australian  2D  ray  tracing  algorithm  {Coleman,  1993]  or  the  Jones- 
Stephenson  3D  ray  trace  model  [Jones  and  Stephenson,  1975]  and  the  resulting  ray  traces  can  be 
viewed.  The  viewing  options  include  a  special  ID  display  window  activated  from  within  the  Ray 
Tracing  Application  or  use  of  the  Ray  Trace  Graphics  Module  within  a  standard  AP-GEOSpace 
3D  window. 

Ray  Tracing  Application  Inputs 

Dynamic  PIM  files  must  have  time  extension  to  work  with  RAYTRACE-APP 

Model:  The  plot  type  field  determines  which  ray  features  are  displayed. 

Australian  2D:  The  Australian  2D  model  algorithm  [Coleman,  1993] 
provides  the  ability  to  plot  rays  along  an  arbitrary 
azimuth.  All  rays  generated  remain  in  the  same  plane. 

Jones-Stephenson  3D:  The  Jones-Stephenson  3D  model  algorithm  [Jones 
and  Stephenson,  1975]  provides  the  ability  to  plot  rays 
in  arbitrary  directions.  Rays  generated  do  not 
necessarily  remain  within  the  same  plane. 
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Freq  (MHz):  Ray  traces  at  one  or  more  frequeneies  can  be  performed  simultaneously. 

Freq  (MHz)  options  inelude: 

The  single  frequeney  option  requires  that  a  single 
frequeney  value  given  in  MHz  be  entered  in  the  Single 
text  box. 

The  multi-frequeney  option  requires  that  a  frequeney 
range  and  inerement  be  speeified. 

From:  The  minimum  frequeney  value  in  MHz. 

To:  The  maximum  frequency  value  in  MHz. 

Step:  The  size  in  MHz  of  the  frequeney  steps  to  be 

taken  starting  at  the  From  value,  e.g.,  if  From 
=  1,  To  =  5,  and  Step  =  2  then  traees  will  be 
ealeulated  at  1,  3,  and  5  MHz  for  eaeh 
elevation. 

Elev  (deg):  Ray  traees  at  one  or  more  elevation  angles  ean  be  performed 

simultaneously.  Elevation  is  an  indieation  of  initial  ray  direetion  measured 
in  degrees  relative  to  the  horizon  with  elevation  equal  to  90  degrees 
representing  zenith.  Elev  (deg)  options  inelude: 

The  single  elevation  angle  option  requires  that  a  single 
elevation  angle  value  given  in  degrees  be  entered  in  the 
Single  text  box. 

The  multi-elevation  angle  option  requires  that  an 
elevation  angle  range  and  inerement  be  speeified. 

Erom:  The  minimum  elevation  angle  value  in 

degrees. 

To:  The  maximum  elevation  angle  value  in 

degrees. 

Step:  The  size  in  degrees  of  the  elevation  steps  to  be 

taken  starting  at  the  From  value,  e.g.,  if  From 
=  10,  7b  =  16,  and  Step  =  2  then  traees  will  be 
ealeulated  at  10,  12,  14,  and  16  degrees  for 
eaeh  frequeney. 

Note:  Up  to  25  rays  ean  be  traeed  per  applieation.  This  fact  should  be  taken  into  consideration 
when  Freq  (MHz)  and  Elev  (deg)  seleetions  are  made. 

Azimuth:  The  Azimuth  value  speeifies  the  initial  angle  of  the  rays  to  be  traeed  with 

azimuth  =  0  indieating  a  northward  traveling  ray. 

Range(1000  km):  The  Range  value  specifies  the  maximum  range  from  the  transmitter 

loeation  that  a  ray  will  be  traeed.  Note:  Results  will  change  if  the  Range  is 
ehanged  beeause  the  ray-traee  step-size  is  a  funetion  of  this  input. 
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Single: 


Multi: 


Single: 


Multi: 


Max  Hops: 


The  Max  Hops  value  speeifies  the  maximum  number  of  hops  or  bounces  a 
traced  ray  can  have  as  it  refracts  off  of  the  ionospheric  plasma  and  reflects 
off  of  the  ground. 

Transmitter  Location:  Transmitter  Location  option  controls  the  coordinates  for  a  ground-based 
transmitter.  The  transmitter  altitude  is  fixed  equal  to  zero. 

Lat:  The  Lat  text  box  is  used  to  set  the  latitude  location  in 

degrees  of  the  transmitter. 

Lon:  The  Lon  text  box  is  used  to  set  the  longitude  in  degrees 

of  the  transmitter. 

Open  Pirn  File:  The  Open  Pim  File  button  is  used  to  select  generated  PIM  data  before 

running  the  ray  trace  application.  Select  Run/Update  from  the  Edit  menu 
only  after  selecting  the  PIM  data.  If  PIM  was  run  in  static  mode,  then  the 
user  should  select  the  pim _pud.out  (default  name)  file  from  a  PIM 
directory  located  in  the  directory  containing  the  AF-GEOSpace 
executable,  e.g.,  select  (Scratch  Directory)\SciPim#  \pim  _pud.out.  If  PIM 
was  run  in  dynamic  mode,  then  the  user  must  select  any  one  of  the 
pim _pud.out  files  with  a  time  extension. 

RAYTRACE-APP  Outputs 

The  RAYTRACE  application  outputs  a  ID  Gridded  Data  set  of  ray  traces  plus  a  slice  of  the  PIM 
electron  densities  approximately  in  the  plane  of  the  traced  rays.  These  outputs  are  displayed 
using  the  RAYTRACE  graphical  object.  If  a  dynamic  PIM  run  was  performed  and  the  file 
extension  option  was  selected  when  running  PIM,  then  the  RAYTRACE-APP  output  will  also  be 
dynamic  with  one  set  of  traced  rays  for  each  PIM  time  frame. 

Plot  Options:  The  Plot  Options  button  activates  a  Ray  Plot  Options  popup  window  used 

to  tailor  the  appearance  of  the  special  ID  plot  activated  by  the  Display 
Plot  button  (see  below).  The  display  options  include: 

Range:  The  Range  text  box  set  controls  the  minimum  {Min) 

and  maximum  {Max)  values  to  be  plotted  as  well  as  the 
number  of  tic  marks  {Tic)  along  the  horizontal  axis 
representing  range  in  km. 

Alt:  The  Alt  text  box  set  controls  the  minimum  {Min)  and 

maximum  {Max)  values  to  be  plotted  as  well  as  the 
number  of  tic  marks  {Tic)  along  the  vertical  axis 
representing  altitude  in  Km. 

Defaults:  The  Defaults  buttons  reset  the  Range  and  Alt  text  box 

values  back  to  their  default  settings.  The  default 
minimum  range  and  altitude  is  0  km.  The  default 
maximum  range  is  12000  km.  The  default  maximum 
altitude  is  600  km. 
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Auto:  The  Auto  buttons  set  the  Min/Max  values  of  Range  and 

Alt  sueh  that  all  of  the  data  fits  in  the  speeial  ID  plot 
window. 

Captions:  Seleeting  this  option  displays  eolor  eoded  eaptions  of 

the  form  “F  #.#  E  #.#”  for  eaeh  ray  traeed,  e.g.,  a 
eaption  “FI  5.0  E20.0”  indieates  that  the  ray  traee  of  the 
same  eolor  as  the  eaption  was  determined  using  a 
frequeney  of  15  MHz  and  was  emitted  at  an  elevation 
angle  of  20  degrees.  Only  the  first  six  rays  are  eolor 
eoded,  the  rest  are  white.  No  eaptions  appear  for  white 
ray  traees.  The  Caption  X  and  Caption  Y  sliders  are 
used  to  position  the  caption  text  within  the  special  ID 
plot. 

Plasma  Frequency:  Selecting  this  option  displays  an  isocontour  of  the 
plasma  frequency  selected  using  the  adjacent  slider. 

The  slider  is  labeled  with  the  relative  frequency  (0.0- 
1 .0),  the  frequency  in  MHz,  and  the  equivalent  plasma 
density  in  #/cm  . 

OK:  The  OK  button  dismisses  the  Ray  Plot  Options  popup 

window. 

Display  Plot:  The  Display  Plot  button  produces  a  special  ID  viewport  displaying  the  ray 

traces  as  a  function  of  altitude  and  range  from  the  transmitting  location. 
The  Plot  Options  button  (see  above)  can  be  used  to  add  color-coded 
captions  providing  frequency  (F)  and  elevation  (E)  information  for  each 
ray  trace  as  well  as  plasma  frequency  contours. 

Note:  In  dynamic  mode,  the  1-D  special  window  animates  only  if  a  3-D  window  containing  the 
corresponding  RAY  TRACE  graphical  object  is  currently  displayed. 
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The  SATEL-APP  Module 

LOKANGL  and  SPACETRK  (SGP4) 

LOKANGL:  18  August  1997 
SPACETRK  (SGP4):  15  August  1997 

EOKANGE:  Radex,  Inc.  (now  AER,  Inc.) 

SPACETRK  (SGP4):  Air  Eorce  Institute  of  Technology  (modified  by 
Radex,  Inc.  (now  AER,  Inc.)) 

Bass,  J.N.,  K.H.  Bhavnani,  B-Z.J.  Guz,  R.R.  Hayes,  P.N.  Houle,  S.T.  Eai, 
and  E.A.  Whelan,  Analysis  and  Programming  for  Research  in  Physics  of 
the  Upper  Atmosphere,  AFGL-TR-76-0231 ,  p.  56-71  (1976) 

(EOKANGE),  ADA  034066 

Kerns,  K.J.,  and  M.S.  Gussenhoven,  CRRESRAD  Documentation,  PL-TR- 
92-2201,  Phillips  Eaboratory,  Hanseom  APB,  MA  (1992)  (EOKANGE), 
ADA  256673 

Note:  It  is  recommended  that  AP-GEOSpace  users  read  the  original  model 
doeumentation  and  descriptive  articles  before  using  the  models. 

SATEL  Overview 

The  SATEE  applieation  module  provides  an  interfaee  to  the  EOKANGE  and  SGP4  orbit 
generation  and  prediction  codes.  The  interface  and  eode  generation  are  shared  among  several 
modules  requiring  eode  orbit  ephemerides.  Other  modules  using  the  orbit  generation  module  are 
the  BPOOTPRINT,  CRRESRAD,  CRRESPRO,  CRRESEEE,  NASAEEE,  NASAPRO,  EET, 
and  TPM  applications. 

SATEL  Inputs 

Input  to  the  SATEE  application  comprises  orbital  elements,  start  and  stop  times  of  the  orbit 
interval  to  be  predicted,  and  parameters  defining  detector  and  link  options.  Several  methods  for 
inputting  the  orbital  elements  are  available. 

The  input  window  is  logically  divided  into  three  areas:  a  propagator/element  type  section,  an 
orbital  element  input  section,  and  an  auxiliary  input  area.  The  paragraphs  below  will  deseribe  the 
inputs  requested  by  eaeh  of  the  three  logieal  input  areas. 

Propagator/Element  Type  Specification 

The  SATEE  applieation  allows  the  orbit  to  be  generated  by  using  either  the  LOKANGLE  or 
SGP4  orbit  propagator  codes.  In  addition,  the  orbital  elements  to  be  used  by  the  propagator  may 
be  specified  in  a  variety  of  ways. 

The  Propagator  input  section  allows  the  user  to  speeify  which  of  the  following  propagators  to 
use  in  calculating  the  orbit, 

Eokangle:  Eokangle,  an  orbit  prediction  code  developed  by  Radex,  Ine.  (now  AER, 

Inc.)  (see  notes  below). 
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SGP4; 


The  SGP4  portion  of  the  SPACETRK  code  developed  by  the  Air  Force 
Institute  of  Technology. 

The  Element  Type  input  section  allows  the  user  to  specify  how  the  orbital  elements  will  be  input. 

The  choices  are 

Mean  Elements:  The  Mean  orbital  elements  will  be  specified.  When  this  selection  is 

chosen,  the  orbital  element  input  section  will  display  text  boxes  and  labels 
for  input  of  Inclination,  Arg.  of  Perigee,  Mean  Anomaly,  Eccentricity, 
Right  Ascension  of  Ascending  Node  and  Mean  Motion  of  the  satellite.  See 
Mean  Elements  Inputs  below  for  more  information.  Note:  When  the  From 
File  option  is  selected,  the  elements  read  from  file  will  appear  in  the  Mean 
Element  text  boxes. 

PW  (ECI):  The  PositionWelocity  orbital  elements  will  be  specified.  When  this 

selection  is  chosen,  the  orbital  element  input  section  will  display  text 
boxes  and  labels  for  input  of  three  position  components  and  three  velocity 
components.  See  P/V  (ECI)  Inputs  below  for  more  information. 

Solar:  The  Solar  orbital  elements  will  be  specified.  When  this  selection  is 

chosen,  the  orbital  element  input  section  will  display  text  boxes  and  labels 
for  input  of  Inclination,  Apogee,  Perigee,  and  local  time  of  Apogee  and 
maximum  latitude.  See  Solar  Inputs  below  for  more  information.  If  the 
Perigee  altitude  is  less  than  the  Apogee  value  entered  then  an  error  popup 
window  appears  and  a  message  is  written  to  standard  output. 

SMean:  The  Simple  Mean  orbital  elements  will  be  specified.  When  this  selection  is 

chosen,  the  orbital  elements  input  section  will  display  text  boxes  and 
labels  for  input  of  Inclination,  Right  Ascension  of  Ascending  Node, 
Argument  of  Perigee,  Apogee  Altitude,  and  Perigee  Altitude  (Mean 
Anomaly  is  fixed  equal  to  zero).  See  SMean  Inputs  below  for  more 
information.  If  the  Perigee  altitude  is  less  than  the  Apogee  value  entered 
then  an  error  popup  window  appears  and  a  message  is  written  to  standard 
output. 

From  File:  It  is  common  to  store  orbital  elements  in  files  of  two-line  NORAD  orbital 

elements.  The  From  File  option  allows  a  user  to  choose  a  file  containing  a 
series  of  two-line  NORAD  elements.  When  this  option  is  chosen,  the 
orbital  element  input  section  will  display  a  list  of  satellite  names 
corresponding  to  the  element  sets  read  from  the  specified  file.  See  Select 
From  File  below  for  more  information  on  this  choice,  the  format  of  the 
NORAD  element  set  file,  and  how  to  obtain  a  file  of  orbital  elements. 
Note:  When  the  From  File  option  is  selected,  the  elements  read  from  file 
will  appear  in  the  Mean  Element  text  boxes. 

Note:  Eokangle  supports  all  of  the  provided  Element  Type  options.  SGP4  supports  all 
Element  Type  options  except  the  position-velocity  element  option  P/V  (ECI). 

Element  Input  Section 

One  of  five  sets  of  text  fields  will  appear  depending  on  the  orbital  Element  Type  selected, 
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(1)  Mean  Elements  Inputs, 

Inelination:  The  inelination  of  the  satellite  orbit  speeified  in  degrees. 

Arg.  of  Perigee:  The  argument  of  the  perigee  of  the  satellite  orbit  measured  in  degrees. 

Mean  anomaly:  The  mean  anomaly  of  the  satellite  orbit  speeified  in  degrees. 

Eeeentrieity:  The  eeeentrieity  of  the  satellite  orbit. 

R.  A.  Ase.  Node:  The  right  aseension  of  the  aseending  node  of  the  satellite  orbit  speeified  in 

degrees. 

Mean  Motion:  The  mean  motion  of  the  satellite  speeified  in  rev/day. 

d(MM)/dt/2:  One-half  the  first  time-derivative  of  the  mean  motion  of  the  satellite  is 

speeified  in  rev/dayf 

One-sixth  the  seeond  time-derivative  of  the  mean  motion  of  the  satellite  is 
speeified  in  rev/dayf 

The  SGP4-type  drag  term  (units  of  Re'^),  the  ballistie  eoeffieient 
represents  how  suseeptible  an  objeet  is  to  drag  with  a  value  of  zero 
representing  no  drag. 

Note:  The  original  PC-based  versions  of  the  CRRESEEE,  CRRESRAD  and 

CRRESPRO  applieations  do  not  use  the  mean  motion  time  derivatives  in  the  orbit 
oaleulations.  Although  the  differenees  should  be  small,  if  preeisely  matehing  the 
original  PC-based  results  is  important  to  the  user,  d(MM)/dt  and  d2(MM)/dt2 
should  be  set  to  zero  when  running  the  BEOOTPRINT,  CRRESEEE, 

CRRESRAD,  CRRESPRO,  NASAEEE,  NASAPRO,  EET,  and  TPM 
applieations. 

(2)  PA^  (ECI)  Input  unit  type  is  eontrolled  by  the  km  and  ft  option  switehes  below  the  veloeity 
text  boxes.  With  the  km  option  seleeted,  position  and  veloeity  values  are  entered  in  units  of  km 
and  km/see,  respeetively.  With  the  ft  option  seleeted,  position  and  veloeity  values  are  entered  in 
units  of  ft  and  ft/see,  respeetively.  After  entering  the  text  field,  switehing  between  the  km  and  ft 
options  will  translate  the  position  and  veloeity  values  automatieally  to  the  other  set  of  units. 

Px,  Py,  Pz:  The  X,  Y,  and  Z  position  of  the  satellite  speeified  in  km.  The  eoordinate 

system  is  Earth  Centered  Inertial  (X  =  first  point  of  Ares,  Y  =  X  x  Z,  Z  = 
north  rotational  pole). 

Vx,  Vy,  Vz:  The  Vx,  Vy,  and  Vz  veloeity  eomponents  of  the  satellite  speeified  in  km/s. 

The  eoordinate  system  is  Earth  Centered  Inertial  (X  =  first  point  of  Ares, 

Y  =  X  X  Z,  Z  =  north  rotational  pole). 

P.  Deeay:  The  period  deeay  of  the  satellite  orbit,  speeified  in  s/rev. 

Note:  The  PC-based  versions  of  the  CRRESEEE,  CRRESRAD  and  CRRESPRO 

applieations  do  not  use  the  period  deeay  in  the  orbit  oaleulations.  Although  the 
differenees  should  be  small,  if  preeisely  matehing  the  PC-based  results  is 
important  then  P.  Decay  should  be  set  to  zero  when  running  the  BEOOTPRINT, 


d2(MM)/dt2/6: 

BSTAR: 
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CRRESELE,  CRRESRAD,  CRRESPRO,  NASAELE,  NASAPRO,  LET,  and 
TPM  applications. 

(3)  Solar  Inputs, 

Inclination: 

Apogee  (km): 

LT  of  Max  Eat: 

Perigee  (km): 

LT  of  Apogee: 

(4)  SMean  Inputs, 

Inelination  (deg): 

RAA  Node  (deg): 

Perigee  Arg  (deg): 

Apogee  Alt  (km): 

Perigee  Alt  (km): 

(5)  Seleet  From  File, 

Files  eontaining  sets  of  NORAD  two-line  element  sets  are  eommonly  available.  The  From  File 
input  option  provides  a  means  of  reading  files  eontaining  element  sets  and  using  them  to 
generate  orbits  in  AF-GEOSpaee.  When  the  From  File  button  is  aetivated  the  Ephemeris  Data 
window  displays  a  label  showing  the  eurrently  opened  fide,  a  Select  File  button  to  open  a  file 
seleetion  box  to  ehange  the  eurrent  file,  and  a  list  of  elements  parsed  from  the  eurrent  file.  When 
the  Sort  button  (next  to  the  Select  File  button)  is  cheeked,  the  next  exeeution  of  Select  File 
returns  an  alphabetieally  sorted  list  of  elements  parsed 

After  a  file  is  opened  the  user  ean  eliek  the  desired  label  in  the  element  seleetion  box  to  ehoose 
the  orbit  elements  assoeiated  with  the  named  satellite.  When  this  is  done,  the  elements  for  the 
ehosen  orbit  are  loaded  and  will  appear  in  the  text  boxes  assoeiated  with  the  Mean  element  type. 

In  order  to  eorreetly  parse  the  element  sets,  AF-GEOSpaee  expeets  the  ehosen  file  to  eontain 
elements  in  a  speeifie  format.  Information  on  the  supported  NORAD  two-line  element  format  is 
available  from  Celestrak.eom  via  anonymous  ftp  (see  below).  A  eopy  of  this  doeument  may  also 
be  found  in  $AFGS_HOME\models\data\EPHEMERIS\NORAD_Two.doo. 

Standard  installations  of  AF-GEOSpaee  Version  2.5.1  set  the  default  start-up  element  file  as 
$AFGS_HOME\models\data\EPHEMERIS\tle.new. 

Files  eontaining  ephemeris  data  for  a  large  number  of  eurrent  and  historie  satellites  are  available 
from  http://Celestrak.com.  A  broad  array  of  satellite  orbit  elasses  are  represented  at  this  site  with 
ephemeris  for  eaeh  type  typieally  stored  in  a  different  text  file,  e.g.,  the  file  goes.txt  eontains 
GOES  satellite  two-line  element  sets.  To  download  the  eurrent  goes.txt  file,  for  example,  go  to 
the  Current  Data  seetion  of  the  website,  right-eliek  on  GOES  and  ehoose  “Save  Link  As”,  and 
plaee  the  file  in  the  $AFGS_HOME\models\data\EPHEMERIS. 


The  inelination  of  the  satellite  orbit  speeified  in  degrees. 

The  altitude  of  the  satellite  orbit  apogee  speeified  in  kilometers. 

The  loeal  time  of  maximum  latitude  (inelination)  speeified  in  hours. 

The  altitude  of  the  satellite  orbit  perigee  speeified  in  kilometers. 

The  loeal  time  of  apogee  speeified  in  hours. 

The  inelination  of  the  satellite  orbit  speeified  in  degrees. 

The  right  aseension  of  the  aseending  node  of  the  orbit  speeified  in  degrees. 
The  argument  of  the  perigee  of  the  satellite  orbit  measured  in  degrees. 

The  altitude  of  the  satellite  orbit  apogee  speeified  in  kilometers. 

The  altitude  of  the  satellite  orbit  perigee  speeified  in  kilometers. 
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Note  that  ephemeris  files  reeeived  from  Celestrak.eom  representing  multiple  satellites  are 
typieally  written  using  the  3-line  format  that  the  AF-GEOSpaee  software  expeets  to  handle. 
These  files  eontain  the  name  of  the  spaeecraft  on  the  first  line  and  the  element  set  on  the  next 
two  lines,  e.g., 


NOAA  9 

1  15427U  84123A  06191.17285276  -.00000060  00000-0  -93142-5  0  3437 

2  15427  98.4952  228.3827  0013953  269.2867  90.6712  14.15238022113188 


NOAA  10 

1  16969U  86073A 

2  16969  98.7581 

NOAA  11 

1  19531U  88089A 

2  19531  98.8270 


06191.20809939  .00000079  00000-0  50616-4  0  2713 

202.8899  0013370  83.8117  276.4588  14.27298964  30444 

06191.20315288  -.00000028  00000-0  85243-5  0  1910 

279.3724  0010851  285.5674  74.4282  14.14811788917794 


Arehive  files  representing  orbit  elements  over  time  for  a  single  spaeeeraft  from  Celestrak.eom 
typieally  do  not  inelude  the  first  line  with  the  spaeeeraft  name,  so  the  user  must  manually  insert 
the  name  if  AF-GEOSpaee  is  expeeted  to  proeess  it  properly.  The  simplest  way  to  aecomplish 
this  is  to  use  standard  word  proeessing  software  and  perform  a  universal  “replaee”,  e.g.,  the 
following  6  lines  in  a  single  text  file  might  represent  three  sets  of  two-line  elements  for  the 
CHAMP  spaeeeraft. 


1  26405U  00039B  02010.72651584  +.00020203  +00000-0  +33586-3  0  0496 

2  26405  087.2608  305.3408  0032340  002.8614  357.2836  15.5131749208398 

1  26405U  00039B  02011.75860482  +.00023132  +00000-0  +38401-3  0  0497 

2  26405  087.2615  304.9473  0032032  358.5732  001.5494  15.5136860408414 

1  26405U  00039B  02012.66165175  +.00026059  +00000-0  +43202-3  0  0500 

2  26405  087.2614  304.6013  0031672  354.9710  005.1235  15.5141864208428 

If  the  eharaeter  string 

“l  26405U” 

is  universally  replaced  by  a  line  with  the  spacecraft  name  (plus  a  line  return)  and  the  characters 
used  to  locate  the  naming  text,  e.g., 

“champ”  (with  a  line  return) 

“l  26405U” 

then  the  file  will  be  properly  formatted  for  AF-GEOSpace  use  and  appear  as  follows. 


CHAMP 

1  26405U  00039B 

2  26405  087.2608 
CHAMP 

1  26405U  00039B 

2  26405  087.2615 
CHAMP 

1  26405U  00039B 

2  26405  087.2614 


02010.72651584  +.00020203  +00000-0  +33586-3  0  0496 
305.3408  0032340  002.8614  357.2836  15.5131749208398 

02011.75860482  +.00023132  +00000-0  +38401-3  0  0497 
304.9473  0032032  358.5732  001.5494  15.5136860408414 

02012.66165175  +.00026059  +00000-0  +43202-3  0  0500 
304.6013  0031672  354.9710  005.1235  15.5141864208428 
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Auxiliary  Input  Section 

The  auxiliary  input  area  is  used  to  specify  information  such  as  the  reference  time  of  the  satellite 
orbit  elements  and  the  time  period  for  which  the  orbit  should  be  calculated.  The  information  is 
either  input  by  the  user  or  loaded  from  the  satellite  ephemeris  files  when  the  From  File  option  is 
used.  Specifically,  the  inputs  are: 

T_ref:  The  reference  time  of  the  orbital  elements  of  the  satellite,  specified  in  the 

form  DD/MMA"Y  HH:MM:SS.SSS 

T_start,  T  stop:  The  start  and  stop  time  for  which  the  orbit  is  to  be  calculated,  specified  in 

the  form  DD/MM/YY  HH:MM:SS.SSS.  Note  that  T_start  and  T  stop 
must  be  greater  than  T_ref  (strictly  enforced  when  using  SGP4 
propagator).  Note  that  if  the  SGP4  propagator  is  used,  the  orbit  interval 
must  be  within  a  year  of  T_ref  or  the  application  will  issue  an  error 
warning.  In  static  mode,  the  default  T_stop  value  is  24  hours  after  T_start. 
In  dynamic  mode,  the  T_start  and  T  stop  times  match  the  Start  and  End 
times  entered  at  the  top  of  the  environment  window. 

Time  Step:  The  time  step  interval  used  to  calculate  the  orbit  is  specified  in  seconds. 

The  orbit  calculation  will  go  from  T_start  to  T  stop  in  Time  Step 
increments. 

Sat.  Name:  A  mnemonic  for  the  satellite  useful  for  display  purposes. 

Time  Step:  The  time  step,  in  seconds,  at  which  the  orbit  should  be  calculated. 

SATEL  Outputs 

The  SATEL  application  outputs  a  ID  Gridded  Data  Set  of  the  position  of  the  selected  satellite  as 
a  function  of  time.  The  output  can  be  viewed  using  the  SATELLITE  graphics  module. 
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The  TPM-l-APP  Module  (V2.5.1  Only) 

Trapped  Proton  Model  (TPM-1) 

Version  1.2,  15  April  2003;  IGRF  updates  2009 
S.  L.  Huston,  The  Boeing  Company 

Huston,  S.L.,  Spaee  Environment  and  Effeets:  Trapped  Proton  Model, 
NASA/CR-2002-2 11784,  NASA  Marshall  Spaeeflight  Center  (2002) 

[see  $APGS_HOME\models\REPS\TPM.pdf] 

Huston,  S.E.,  and  K.A.  Pfitzer,  Spaee  Environment  Effects:  Low  Altitude 
Trapped  Proton  Model,  NASA/CR-1 998-208593,  NASA  Marshall 
Spaceflight  Center  (1998) 

Huston,  S.L,  G.A.  Kuck,  and  K.A.  Pfitzer,  Low  altitude  trapped  radiation 
model  using  TIROS/NOAA  data,  in  Radiation  Belts:  Models  and 
Standards,  J.E.  Lemaire,  D.  Heynderickx,  and  D.N.  Baker  (eds.). 
Geophysical  Monograph  97,  American  Geophysical  Union,  119  (1996) 

Meffert,  J.D.,  and  M.S.  Gussenhoven,  CRRESPRO  Documentation,  PL- 
TR-94-2218,  Phillips  Laboratory,  Hanscom  AEB,  MA  (1994),  ADA 
284578 

Olson,  W.P.,  and  K.A.  Pfitzer,  Magnetospheric  Magnetic  Eield  Modeling, 
Annual  Scientific  Report,  Air  Eorce  Office  of  Scientific  Research  contract 
P44620-75-C-0033,  McDonnell  Douglas  Astronautics  Co.,  Huntington 
Beach,  CA  (1977),  ADA  037492 

Note:  It  is  recommended  that  AE-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

TPM-l-APP  Overview 

The  TPM-1  science  and  application  modules  are  based  on  the  Trapped  Proton  Model  (TPM) 
developed  by  Boeing  Corporation  for  the  NASA  Space  Environment  and  Effects  (SEE)  Program 
[Huston,  2002].  TPM  combines  both  the  Low  Altitude  Trapped  Radiation  Model  (LATRM) 
[Huston  et  al,  1998],  also  developed  by  Boeing  for  NASA/SEE,  and  the  Air  Eorce  Research 
Laboratory's  (AERL)  CRRESPRO  model  [Meffert  and  Gussenhoven,  1994]  covering  higher 
altitudes.  More  information  on  TPM-1  can  be  found  in  the  TPM-1  Science  Module  section  of 
this  document. 

The  CRRESPRO-APP  module  calculates  proton  omni-directional  fiuence  (differential  and 
integral)  over  the  energy  range  1-100  MeV  for  user  specified  orbits  and  quiet  or  active 
geophysical  conditions.  Eor  this  application,  the  TPM-1  data  base  is  accessed  and  copied  to  a 
local  (time  dependent)  set  of  data  files  in  CRRESPRO  format.  The  calculation  of  fluences  then 
proceeds  in  the  same  manner  as  in  CRRESPRO-APP. 

Integral  omni-directional  fiuence  for  a  given  energy  channel  is  calculated  from  the  differential 
omni-directional  fiuence  by  summing  over  all  energy  channels  with  energy  greater  than  the 
given  channel  (eliminating  those  with  overlapping  energy  ranges,  channels  5  and  15)  and 
multiplying  by  appropriate  bandwidths,  as  discussed  in  the  CRRESPRO  Science  Module. 
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Model  Name: 
Version: 
Developer: 
References: 


Note:  The  TPM-1  Science  Module  need  NOT  be  run  before  TPM-l-APP. 

TPM-l-APP  Inputs 

The  inputs  to  the  TPM-l-APP  module  are  the  orbit  elements  needed  to  calculate  the  satellite 
orbit.  The  Environment  Window  for  the  TPM-l-APP  module  is  the  same  as  that  for  the  SATEL- 
APP  application  except  TPM-l-APP  is  set  to  use  the  orbit  propagator  Eokangle.  See  the  SATEE- 
APP  Module  section  of  the  documentation  for  input  descriptions.  The  IGRE/O-P  magnetic  field 
model  is  used  with  extrapolation  beyond  2010. 

TPM-l-APP  Outputs 

The  TPM-APP  Applications  Module  generates  a  return  text  window  which  can  be  displayed 
using  the  Show  Text  button  if  it  has  been  closed.  Included  in  the  text  are  the  orbit  elements  and 
tables  of  both  the  differential  and  integral  omni-directional  fiuences  (in  units  of  #/(cm^MeV  yr) 
and  #/(cm^  yr),  respectively)  calculated  for  all  22  retained  energy  channels  and  for  both  active 
and  quiet  conditions.  Also  generated  is  a  ID  Gridded  Data  Set  giving  the  position  of  the  satellite 
as  a  function  of  time  that  can  be  displayed  using  the  Satellite  Graphics  Module. 
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The  WBPROD-APP  Module  (V2.5.1  and  Static  Only) 

Model  Name:  Wide-Band  Model  (WBMOD) 

Version:  September  1998  (Uses  WBMOD  Version  15.03  of  08  July  2005) 

Developer:  USAF  55SWXS,  Air  Foree  Researeh  Laboratory,  and  Radex,  Inc.  (now 

AER,  Inc.) 

References:  Secan,  J.A.,  and  R.M.  Bussey,  An  Improved  Model  of  High-Latitude  F- 

Region  Scintillation  (WBMOD  Version  13.04),  PL-TR-94-2254  (1994), 
ADA  288558 

Note:  It  is  recommended  that  AF-GEOSpace  users  read  the  original  model 
documentation  and  descriptive  articles  before  using  the  models. 

WBPROD-APP  Overview 

The  WBPROD-APP  application  produces  a  24-hour  forecast  of  the  95th  percentile  dB  fade 
levels  along  user-specified  communication  Imk(s)  between  a  receiver  site  and  satellites.  The 
WBMOD  climatological  ionospheric  scintillation  model  is  used  and  is  described  in  more  detail 
in  the  WBMOD  Science  Module  section  of  this  User's  Manual.  In  the  science  module,  WBMOD 
is  executed  in  a  transmitter-  or  receiver-step  mode  at  a  fixed  time.  This  application  executes 
WBMOD  in  a  time-step  mode  with  the  communication  link(s)  fixed  in  location.  WBPROD-APP 
outputs  a  summary  text  file  of  the  hourly  95th  percentile  fades  for  a  specified  day  of  year  and 
ground-to-satellite  link.  Multiple  satellite  links  to  a  single  ground  point  can  be  written  to  the 
same  file.  An  option  also  exists  to  output  a  text  file  with  the  set  of  WBMOD  parameters  for  the 
specified  link. 

Note:  WBPROD-APP  does  not  produce  gridded  output  data  for  viewing  with  the  AE- 
GEOSpace  graphics  modules.  This  module  is  a  tailored  product  designed  to  run 
WBMOD  scripts  quickly  and  efficiently.  This  is  an  excellent  tool  for  generating 
scintillation  products  required  for  routine  customers. 

WBPROD-APP  Inputs 

The  following  Run  Variables  are  mandatory. 

Note:  This  application  DOES  NOT  use  the  AE-GEOSpace  global  parameters  at  the  top 
of  the  Environment  Window,  but  uses  those  entered  in  the  following  text  fields. 

Day#:  The  day  of  the  year,  e.g.,  1  =  1  Jan  and  365  =  31  Dec  (for  non-leap  year). 

Kp:  The  average  geomagnetic  Kp  index  forecast  for  the  day. 

SSN:  The  sunspot  number  forecast  for  the  day. 

The  following  Station  variables  are  required  to  specify  the  ground  station  location. 

Name:  Name  of  the  ground  station.  If  you  saved  a  previous  session  and  wish  to 

re-load  it,  type  in  the  name  of  the  ground  station  (exactly  as  named  before) 
and  click  on  the  Load  Script  button  (see  related  discussion  below). 

Eat  (deg  N):  The  geographic  latitude  of  the  ground  station  in  degrees  North. 
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Lon  (deg  E):  The  geographie  longitude  of  the  ground  station  in  degrees  East. 

Alt  (km):  The  altitude  of  the  ground  station  above  sea  level  in  kilometers. 

The  following  Satellite  variables  are  required  to  specify  the  locations  and  communication 
frequencies  for  the  satellites, 

Name:  The  satellite  name  (must  be  unique). 

Eat  (deg  N):  The  geographic  latitude  of  the  satellite  in  degrees  North.  Remember,  this 

application  steps  WBMOD  in  time,  the  satellite  link  will  be  fixed  in 
position. 

Eon  (deg  E):  The  geographic  longitude  of  the  satellite  in  degrees  East.  Remember,  this 

application  steps  WBMOD  in  time,  the  satellite  link  will  be  fixed  in 
position. 

Alt  (km):  The  satellite  altitude  above  the  center  of  the  Earth  in  kilometers.  Note  that 

station  altitude  is  specified  using  a  different  zero  point.  Because  the 
current  version  of  WBMOD  does  not  include  doppler  effects  due  to 
satellite  velocity,  it  is  recommended  that  only  geosynchronous  satellite 
positions  are  inputted  (Alt  ~  36,000  km). 

Ereq  (MHz):  The  carrier  frequency  of  the  communications  signal  in  MHz. 

Once  the  satellite  variables  have  been  input,  the  satellite  must  be  added  to  the  active  satellite  list 
displayed  at  the  bottom  of  the  window  by  clicking  on  the  Add/Update  button.  Additional 
satellites  can  then  be  entered  in  the  variable  boxes  and  added  to  the  list  in  a  similar  fashion. 
Satellites  can  be  deleted  from  the  list  by  first  clicking  on  the  satellite  name  in  the  active  satellite 
list  and  then  clicking  on  the  Delete  button.  WBPROD-APP  will  produce  forecasts  for  all  the 
satellites  in  the  active  satellite  list. 

Before  running  WBPROD-APP,  the  Save  Script  button  must  be  clicked.  This  will  save  the 
station  and  satellite  parameters  in  a  file  labeled  stationname.wb,  where  stationname  is  the  Name 
entered  for  the  station  in  the  current  window. 

The  Load  Script  button  resets  inputs  from  the  last  Save  Script  action  and  not  from  a  previous 
session.  Use  the  Save  Model  option  from  the  File  menu  to  save  session  details  for  future  use. 

The  file  entitled  stationname.wb,  where  stationname  is  the  Name  entered  for  the  station  in  the 
current  window  will  be  loaded  into  WBPROD-APP. 

The  user  can  choose  to  have  either  a  Summary  output  (SI  index  only)  or  All  the  WBMOD  output 
parameters  saved  to  a  file  by  selecting  the  appropriate  Text  option  before  execution. 

Note:  The  Save  Script  button  must  be  clicked  before  executing  WBPROD-APP  or  else 
the  last  saved  script  will  be  run. 

WBPROD-APP  Outputs 

Use  the  Display  Text  button  to  display  output  in  an  AE-GEOSpace  text  window.  The  following 
options  are  available. 

Summary:  Creates  an  ASCII  text  file  labeled  stationname _summary,  where 

stationname  is  the  Name  entered  for  the  station  in  the  current  session.  This 
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All: 


file  lists  the  hourly  values  of  the  95th  pereentile  fades  for  links  from  the 
ground  station  to  all  the  satellites  in  the  aetive  satellite  list.  Fades  are 
reported  as  negative  values  (dB). 

Creates  an  ASCII  text  file  labeled  stationname_all,  where  stationname  is 
the  Name  entered  for  the  station  in  the  eurrent  session.  This  file  lists  the 
hourly  values  of  all  the  WBMOD  output  parameters  including  S4,  sigma 
phi,  95th  percentile  fade,  STDEV  LOG(I),  and  %Time  for  links  from  the 
ground  station  to  all  the  satellites  in  the  active  satellite  list.  See  the 
WBMOD  Science  Module  section  of  this  User's  Manual  for  further  details. 
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GRAPHICS  MODULES 


Graphics  modules  are  used  to  visualize  the  data  sets  ereated  with  the  Application,  Data,  and 
Science  modules.  The  inputs  to  a  graphics  module  are  ID,  2D,  3D,  Spectral,  or  Heliospace  Data 
Sets  and  the  outputs  are  defined  as  graphical  objects.  A  variety  of  graphics  modules  are  provided 
for  one-,  two-,  and  three-dimensional  visualization.  The  graphics  modules  are  aceessed  through 
the  graphics  manager  that  beeomes  visible  when  the  Graphics  option  in  the  Module  pulldown 
menu  is  aetivated.  The  graphics  manager  eonsists  of  two  lists  -  Available  Modules  and  Active 
Modules.  Available  Modules  are  the  modules  that  are  eurrently  supported  by  AF-GEOSpaee. 
Active  Modules  are  modules  that  have  been  created  and  used  by  the  AF-GEOSpaee  user  during 
the  eurrent  session. 

When  initially  aeeessed,  the  graphies  manager  will  show  a  list  of  graphies  under  Available 
Modules  and  the  Active  Modules  list  will  be  empty. 

Currently,  the  following  graphics  are  supported  by  AF-GEOSpace: 

•  ANNOTATION:  Create  and  display  deseriptive  text  or  time  labels  for  viewports. 

•  AXES:  Plot  a  set  of  axes  or  the  sun  vector. 

•  COORD-PROBE:  Provides  a  method  for  probing  data  along  lines  defined  in  user-specified 
eoordinate  systems. 

•  COORD-SLICE:  Display  a  slice  of  a  data  set  along  a  constant  coordinate  surface. 

•  DETECTOR:  Define  and  assoeiate  fixed  or  tracking  detector  cones  with  satellites  or  station 
locations. 

•  DMSP:  Display  DMSP  precipitating  particle  data  (proeessed  using  the  DMSP  Data  Module) 
in  ID  and  Speetral  windows. 

•  EARTH:  Plot  an  outlined  or  solid  Earth.  A  variety  of  outline  detail  and  grid  options  are 
available. 

•  EMITTER:  Define  and  assoeiate  fixed  or  tracking  emitters,  e.g.,  radar  fan  structures,  with 
satellites  or  stations. 

•  FIELD-LINES:  Plot  magnetic  field  lines,  flux  tubes,  and  auroral  equatorward  boundaries. 

•  GLOBAL  INPUTS:  Produce  a  line  plot  of  the  global  input  data  values,  e.g.,  Kp  or  Dst,  as  a 
funetion  of  time. 

•  GRID;  Plot  the  grid  associated  with  a  data  set. 

•  lONSCINT-G:  Display  platform-based  GPS  frequeney  S4  scintillation  simulation  results 
(generated  using  the  lONSCINT-G  Seience  Module)  in  1-D  and  Spectral  windows. 

•  ISOCONTOUR;  Calculate  an  isocontour  of  a  data  set  and  plot  the  resulting  surface. 

•  LINK:  View  a  line-of-sight  link  between  stations  and  satellites  or  between  satellites. 

•  ORBIT-PROBE:  Plot  data  sets  from  along  satellite  orbits. 

•  ORBIT-SLICE:  Cut  the  data  set  with  a  plane  placed  at  the  orbital  plane  of  a  satellite  (or  a 
plane  perpendicular  to  or  containing  the  satellite  veloeity  vector)  and  plot  the  resulting  slice. 
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•  PLANE-SLICE:  Cut  the  data  set  with  an  arbitrary  plane  and  plot  the  resulting  sliee. 

•  RAY  TRACE:  Produce  a  depiction  of  the  ionospheric  rays  traced  through  the  PIM  science 
model  data  sets. 

•  SATELLITE:  Provides  a  means  of  viewing  satellite  trajectories,  detector  cones,  and 
communications  links. 

•  STARS:  Plot  the  celestial  background  including  stars,  planets,  and  the  moon. 

•  STATION:  Plot  a  labeled  location  on  or  above  the  surface  of  the  Earth. 

•  VOLUME:  View  the  entire  volume  of  a  data  set  as  a  single  three-dimensional  object 

•  PARAMESH-COORDSLICE:  Produce  a  slice  or  constant  coordinate  surface  through  a 
PARAMESH  data  set. 

•  PARAMESH-FIELDLINES:  Produce  field  lines  generated  by  tracing  a  vector  field  through 
a  PARAMESH  data  set. 

•  PARAMESH-FIELDLINES  II:  Produce  field  lines  generated  by  tracing  a  vector  field 
through  a  PARAMESH  data  set. 

•  PARAMESH-GRID:  Display  the  grid,  block  structure  (e.g.,  leaf  and  parent  block),  and 
overall  domain  of  a  PARAMESH  data  set. 

•  PARAMESH-ISOCONTOUR:  Produce  a  surface  of  constant  value  through  a  three- 
dimensional  PARAMESH  data  set. 

•  PARAMESH-VOLUME:  View  the  entire  volume  of  a  PARAMESH  data  set  as  a  single 
three-dimensional  object. 
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Running  Graphics  Modules 

To  run  a  graphics  module,  use  the  mouse  to  seleet  the  Graphics  option  in  the  Module  pulldown 
menu  and  Available  Modules  and  Active  Modules  lists  will  appear  in  the  Environment  Window. 
Cliek  on  the  desired  ehoiee  under  Available  Modules.  For  example,  to  ereate  a  new  COORD 
SLICE,  eliek  the  mouse  on  Coord  Slice  in  the  Available  Modules  list.  Choosing  a  graphies 
module  will  do  two  things:  first,  the  ehoiee  is  added  to  the  Active  Modules  list;  seeond,  the 
options  assoeiated  with  the  ehosen  graphies  module  will  appear  in  the  Environment  Window.  In 
general,  eaeh  graphies  module  will  have  a  different  Environment  Window  representing  the 
module  speeifie  inputs.  Before  attempting  to  display  a  graphies  objeet,  adjust  the  settings  and/or 
seleet  an  existing  data  set  from  the  options  presented  in  the  Environment  Window. 

The  Display  seleetor  plaees  the  graphieal  objeet  in  the  aetive  viewport  window.  Note  that  this 
seleetor  is  only  aetive  when  the  dimensionality  of  the  data  is  appropriate  for  the  eurrent  aetive 
window,  e.g.,  3D  data  eannot  be  displayed  in  a  ID  viewport.  If  required,  use  one  of  the  Create 
Viewport  options  in  the  Window  pulldown  menu  to  ereate  a  window  of  appropriate 
dimensionality  or  use  the  Projection  option  in  the  Viewport  pulldown  menu  to  ehange  the 
dimensionality  of  the  aetive  viewport  window. 

Alternating  the  Projection  option  in  the  Viewport  pulldown  menu  between  Two  D  and  Three  D  is 
one  way  to  view  the  same  data  in  both  dimensions.  An  even  easier  method  is  to  use  the  Split 
option  in  the  Viewport  pulldown  menu  to  divide  a  2D  (3D)  viewport  and  then  ehange  the 
dimensionality  of  one  of  the  viewports  to  3D  (2D). 

The  Interactive  seleetor  (usually  aetive  by  default)  eontrols  whether  graphieal  renderings  are 
updated  as  ehanges  are  made  to  the  graphie  inputs. 

The  Use  Texture  seleetor  (usually  aetive  by  default)  option  improves  the  appearanee  of  eolor 
data  eontours  and  its  use  is  reeommended. 

The  appearanee  of  the  graphieal  objeet  also  be  modified  using  the  Lighting,  Clipping, 
Transparency,  Lights,  Material,  Color,  Color  Map,  and  Data  Map  options  also  available  in  the 
Environment  Window.  See  the  Graphieal  Module  Options  seetion  of  this  manual  for  details  of 
these  features. 

The  Animate  Tool  option  in  the  Edit  pulldown  menu  ean  be  used  to  display  data  produeed  in 
dynamie  mode,  i.e.,  if  a  seienee  or  applieation  module  was  run  using  a  Start  and  End  time. 
SATEL-APP  module  output,  i.e.,  satellite  orbits,  ean  be  animated  using  this  tool  even  if  when 
run  in  statie  mode  beeause  the  satellite  module  permits  setting 

The  Delete  option  in  the  Edit  pulldown  menu  is  used  to  remove  the  highlighted  seienee  module 
member  of  the  Active  Modules  list.  Note  that  all  aetive  graphies  objeets  must  be  removed  before 
the  seienee  module  used  to  generate  their  data  ean  be  removed. 
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ANNOTATION 


The  ANNOTATION  graphical  object  is  used  to  display  fixed  text  messages  or  the  time  and  date 
in  the  graphics  windows. 

The  ANNOTATION  graphical  object  rendering  is  dependent  on  the  window  type. 

In  a  ID  window,  the  ANNOTATION  graphical  object  displays  text  in  the  graphics  window. 

In  a  2D  window,  the  ANNOTATION  graphical  object  displays  text  in  the  graphics  window. 

In  a  3D  window,  the  ANNOTATION  graphical  object  displays  text  in  the  graphics  window. 

In  a  HelioSpace  window,  the  ANNOTATION  graphical  object  displays  text  in  the  graphics 
window. 

In  a  Spectral  window,  ANNOTATION  does  nothing. 

The  ANNOTATION  graphical  object  supports  the  Color  option. 


ANNOTATION  Inputs 

Text:  The  Text  field  can  be  edited  to  contain  the  text  to  be  displayed  in  the 

graphics  window.  The  text  will  not  appear  while  the  Show  Data  option  is 
activated. 

Show  Date:  This  option  displays  the  time  and  date  in  place  of  the  contents  of  the  Text 

field. 


Font:  The  Font  selector  controls  the  font  size  used  for  the  annotation.  The 

options  include  the  machines  Default  font  (size  20)  and  Times  font  (sizes 
10,  20,  30,  40,  and  50). 

X  Position:  The  X Position  slider  is  used  to  position  the  annotation  in  the  horizontal 

direction. 

Y  Position:  The  Y  Position  slider  is  used  to  position  the  annotation  in  the  vertical  direction. 
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AXES 


The  AXES  graphical  object  will  produce  a  set  of  AXES  for  different  coordinate  systems.  It  will 

also  produce  a  vector  representing  the  sun  direction,  given  the  current  time  as  set  by  the  LIT 

Global  parameter  or  the  Animation  Window. 

The  AXES  graphical  object  rendering  is  dependent  on  the  window  type. 

In  a  ID  window,  the  AXES  graphical  object  does  nothing. 

In  a  2D  window,  the  AXES  graphical  object  does  nothing. 

In  a  3D  window,  the  AXES  graphical  object  plots  lines  representing  X,  Y,  and  Z  axes  with  the 

origin  at  the  center  of  the  Earth. 

In  a  Heliospace  window,  AXES  does  nothing. 

In  a  Spectral  window,  AXES  does  nothing. 

The  AXES  graphical  object  supports  the  Color  option. 

AXES  Inputs 

Axes  Erame:  The  coordinate  system  in  which  the  axes  should  be  aligned.  Assigned  axis 

colors  can  be  changed  using  the  Color  display  option.  Choices  are; 

GEOC:  Geocentric  coordinate  system  axes;  The  Z  axis  (blue)  is 

aligned  with  the  north  rotational  pole,  the  X  axis  (red) 
pierces  the  Greenwich  Meridian  on  the  equator  (0  deg 
Eong,  0  deg  Eat),  and  the  Y  axis  (green)  is  equal  to  the 
negative  of  the  cross-product  of  X  and  Z. 

GET  Geocentric  equatorial  inertial  coordinate  system  axes; 

The  Z  axis  (blue)  is  the  same  as  for  the  GEOC 
coordinate  system.  The  X  axis  (red)  is  aligned  along  the 
vernal  equinox.  The  angle  between  the  vernal  equinox 
and  the  Greenwich  Meridian  is  set  using  the  current  UT 
from  the  Animation  Window. 

GSM;  Geocentric  solar  magnetospheric  coordinate  system 

axes;  The  X  axis  (red)  points  to  the  Sun.  The  Z  axis 
(blue)  is  perpendicular  to  X  and  lies  in  the  plane 
containing  the  magnetic  dipole  axis.  The  Y  axis  (green) 
completes  the  right-handed  system  and  is  positive 
towards  dusk. 

SM;  Solar  magnetic  coordinate  system  axes;  The  X  axis 

(red)  is  perpendicular  to  Z  and  lies  in  the  plane 
containing  the  Z  axis  and  the  Earth-Sun  line.  The  Z  axis 
(blue)  is  coincident  with  the  magnetic  dipole  axis.  The 
Y  axis  (green)  completes  the  right-handed  system  and  is 
positive  towards  dusk. 
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Sun  vector; 


Solar  direction  axis;  The  direction  of  the  sun  (yellow)  is 
based  on  the  current  UT  from  the  Animation  Window. 


Axes  Specification; 


Axes  Length; 


This  section  controls  the  display  of  the  axes.  The  options  are; 

Show  Axes;  For  each  of  the  axis  components,  activating  the  Show 
Axes  toggle  button  makes  the  axis  visible. 

Show  Tics;  For  each  of  the  axis  components,  activating  the  Show 

Tics  toggle  button  makes  the  tick  marks  on  the  axis 
visible. 

Major  Tic  Spacing;  The  spacing  (in  Re)  between  major  tick  marks. 

Minor  Tic  Spacing;  The  spacing  (in  Re)  between  minor  tick  marks. 

The  Axis  Length  slider  controls  the  length  of  the  axis  to  be  drawn.  Units 
are  Earth  radii  (Re). 
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COORD-PROBE 


The  COORD-PROBE  graphical  object  is  used  to  produce  a  line  plot  through  a  data  set.  The  line 
variable  may  be  specified  along  a  given  coordinate  direction  in  one  of  several  coordinate 
systems. 

The  COORD-PROBE  graphical  object  rendering  is  dependent  on  the  window  type. 

In  a  ID  window,  the  COORD-PROBE  graphical  object  produces  a  line  plot  of  data  values 
colored  according  to  the  parameter  value. 

In  a  2D  window,  COORD-PROBE  will  project  the  line  through  the  data  set  onto  a  2D  grid  of 
longitude  (horizontal)  and  latitude  (vertical).  Note:  Use  the  Earth  grid  to  frame  the  plot. 

In  a  3D  window,  COORD-PROBE  will  display  the  line  through  the  data  set  in  three-dimensional 
space  around  the  Earth. 

In  a  Heliospace  window,  COORD-PROBE  does  nothing. 

In  a  Spectral  window,  COORD-PROBE  does  nothing. 

The  COORD-PROBE  graphical  object  supports  the  Color  and  Data  Map  options. 

COORD-PROBE  Inputs 

Data:  This  option  menu  is  used  to  select  the  main  data  set  the  COORD-PROBE 

is  to  be  taken  through.  This  option  must  be  set  before  rendering  is  allowed. 
The  option  menu  contains  a  list  of  valid,  previously  run  science,  data,  and 
application  data  sets. 

System:  The  coordinate  system  in  which  the  coordinate  line  will  be  generated.  The 

user  may  select  to  probe  the  data  set  in  geocentric  {GEOC),  geocentric 
solar  magnetospheric  {GSM),  solar  magnetic  {SM),  or  geocentric 
equatorial  inertial  {GEI)  coordinates. 

Geometry:  Specify  the  geometry  in  which  the  coordinate  line  will  be  generated.  The 

user  may  select  Cartesian,  Cylindrical,  or  Spherical  geometry. 

Vary:  Specify  the  coordinate  along  which  the  probe  is  to  vary.  These  options 

will  change  depending  on  the  settings  of  the  Data,  System,  and  Geometry 
inputs.  In  the  cylindrical  geometry,  for  example,  the  Vary  selections  will 
read  Radius,  Phi,  and  Z.  The  two  sliders  below  the  Vary  options  control 
the  values  of  the  two  fixed  coordinates. 

Steps:  The  number  of  points  along  the  coordinate  variable  at  which  the  data  set  is 

to  be  sampled. 

Type:  The  Type  options  are  used  to  select  how  the  linear  data  are  plotted,  i.e.,  as 

discrete  points  {Point),  a  solid  line  {Line),  or  stippled  line  {Stipple  1  and 
Stipple  2). 

Thickness:  The  Thickness  slider  controls  the  width  of  plotted  points  and  lines. 

X  Axis:  Displayed  XZxA  features  are  controlled  by  the  following  options: 
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Y-Axis: 


Save: 


Enabled: 


Grid: 


Min,  Max: 


Auto: 


Format: 


Num  Ties: 


The  Enabled  cheek  box  controls  the  display  of  axis 
labels. 

The  Grid  check  box  places  grid  lines  at  axis  tic  mark 
locations. 

The  Min  and  Max  text  boxes  are  used  to  control  the 
range  of  values  plotted.  After  editing  either  value,  the 
plot  will  update  when  the  cursor  is  placed  in  any  one  of 
the  other  text  boxes  in  the  environment  window. 

The  Auto  button  adjacent  to  the  Min  and  Max  text  boxes 
automatically  resets  the  plot  range  to  the  minimum  and 
maximum  values  of  the  data  set. 

The  Format  text  box  determines  the  format  of  the  tic 
mark  labels.  “C”-like  format  statements  are  accepted, 
e.g.,  “%5.2f  ’  will  label  the  tics  using  floating  point 
numbers  with  two  decimal  places.  Substitute  an  “e” 
for  “f  ’  and  exponential  formatting  will  be  used.  After 
editing  a  Format  text  box,  the  display  will  update  when 
the  cursor  is  placed  in  any  other  text  box  in  the 
environment  window. 

The  Num  Tics  text  box  controls  the  number  of  labels 
and  tic  marks  along  the  axis.  Update  by  placing  the 
cursor  in  another  text  box. 


The  Y  Axis  options  are  the  same  as  the  X Axis  options  described  above 
with  the  following  additional  capabilities: 

Side:Left,  Right:  The  Left  and  Right  buttons  determine  the  display  side  of 
the  axis  labels. 


Log:  The  Log  check  box  activates  the  use  of  a  log  base  10 

scale.  When  applied  to  number  values  less  than  or  equal 
to  zero,  the  Log  function  will  display  a  “-6”  on  the  log 
scale. 


The  Save  button  activates  a  Save  As  popup  window  used  to  save  the  1-D 
displayed  data  to  a  text  file.  Designated  file  names  should  end  with  “.txt” 
for  viewing  convenience. 
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COORD-SLICE 


The  COORD-SLICE  graphical  object  is  used  to  produce  a  slice  or  surface  through  a  data  set.  The 
slice  is  produced  along  a  constant  of  one  coordinate  direction.  For  example,  if  the  data  set  was 
produced  on  a  spherical  grid,  the  COORD-SLICE  graphical  object  can  produce  slices  at  constant 
radius,  constant  latitude,  or  constant  longitude.  If  the  data  set  was  produced  using  a  Cartesian 
grid,  the  COORD  SLICE  graphical  object  could  produce  a  slice  at  constant  X,  Y,  or  Z  value. 

The  COORD-SLICE  graphical  object  rendering  is  dependent  on  the  window  type. 

In  a  ID  window,  the  COORD-SLICE  graphical  object  does  nothing. 

In  a  2D  window,  COORD-SLICE  will  project  the  constant  coordinate  slice  onto  the  Earth’s 
surface.  Note  that  for  this  to  be  meaningful,  the  slice  should  be  produced  at  constant  altitude  on  a 
spherical  grid,  i.e.,  use  Cut  Plan  CO. 

In  a  3D  window,  COORD-SLICE  will  display  the  coordinate  slice  through  the  data  set  in  three- 
dimensional  space  around  the  Earth. 

In  a  Heliospace  window,  COORD-PROBE  does  nothing. 

In  a  Spectral  window,  COORD-PROBE  does  nothing. 

The  COORD-SLICE  graphical  object  supports  the  Clipping,  Transparency,  Lights,  Material, 
Color,  Color  Map,  and  Data  Map  options. 

COORD-SLICE  Inputs 

Data:  The  Data  option  menu  is  used  to  select  the  main  data  set  the  COORD- 

SLICE  is  to  be  taken  through.  This  option  must  be  set  to  a  data  set  before 
rendering  is  allowed.  The  option  menu  contains  a  list  of  valid,  previously 
run  science,  data,  and  application  data  sets. 

Block  Rendering:  The  Block  Rendering  option  displays  the  data  using  single-colored  blocks 

centered  on  grid  points  which  are  colored  according  to  the  their  data  value. 

Cut  Plane:  The  Cut  Plane  option  defines  the  constant  coordinate  from  the  choices  CO, 

Cl,  and  C2.  The  generic  names  represent  specific  coordinate  choices 
depending  upon  the  grid  type  of  the  data  set.  For  example,  if  the  grid  type 
of  the  data  set  is  spherical,  CO  will  produce  a  slice  at  constant  radius;  Cl 
will  produce  a  slice  at  constant  latitude;  C2  will  produce  a  slice  at  constant 
longitude.  Similarly,  if  the  data  set  has  a  Cartesian  grid,  the  CO,  Cl,  and 
C2  will  produce  slices  at  constant  X,  Y,  and  Z,  respectively. 

Display  Options:  The  Display  Options  field  will  allow  the  COORD-SLICE  to  be  filled  as 

colored  or  white  contours,  filled  or  discrete.  Any  combination  of  the 
options  may  be  selected. 

Filled:  Render  the  COORD-SLICE  as  solid,  filled,  color 

contours. 

Grey:  If  the  grid  extends  beyond  meaningful  data 

in  the  data  set,  the  points  without  valid  data 
will  be  filled  in  as  grey. 
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Contours: 


Position  Value: 


Number  of  Contours: 


Render  the  COORD-SLICE  as  diserete  white  lines.  The 
lines  represent  isovalues  of  the  data  evenly  spaeed 
between  the  data  minimum  and  the  data  maximum.  The 
number  of  eontours  is  determined  by  the  Number  of 
Contours  input. 

Color  The  isovalue  lines  are  eolored  aeeording  to 
the  eolor  bar  to  represent  the  magnitude  of 
the  isovalue. 

Grid:  An  outline  of  the  grid  will  be  shown  in  the  plane  of  the 

eoordinate  sliee. 

The  Position  Value  option  determines  the  position  of  the  eoordinate  sliee. 
The  position  value  represents  the  position  along  the  constant  coordinate. 
For  example,  if  the  dataset  has  a  spherical  grid  and  the  CO  coordinate  is 
chosen,  COORD-SLICE  will  produce  a  slice  at  constant  radius.  The 
position  value  input  will  select  the  value  of  the  radius  at  which  to  produce 
the  slice.  The  value  will  range  from  the  grid  minimum  to  the  grid 
maximum  for  the  chosen  coordinate. 

The  Number  of  Contours  input  slider  determines  the  number  of  contour 
lines  to  be  plotted  between  the  data  minimum  and  the  data  maximum  if  the 
Display  Option  selection  is  just  Contours  or  Contours:  Color  (see  above). 
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DETECTOR 


The  DETECTOR  graphical  object  is  used  to  view  a  detector  located  at  a  station  or  in  orbit  on  a 
satellite.  The  stations  and  satellites  to  be  associated  with  a  detector  must  have  been  displayed 
previously  using  the  STATION  graphics  module  and  the  SATEE-APP  and  SATEEEITE 
modules,  respectively. 

The  DETECTOR  graphical  object  rendering  is  dependent  on  the  window  type. 

In  a  ID  window,  the  DETECTOR  graphical  object  does  nothing. 

In  a  2D  window,  the  DETECTOR  graphical  object  displays  the  detector  cone  footprint  on  the 
Earth’s  surface. 

In  a  3D  window,  the  DETECTOR  graphical  object  displays  a  cone  in  space  around  the  Earth. 

In  a  Heliospace  window,  DETECTOR  graphical  object  does  nothing. 

In  a  Spectral  window,  DETECTOR  graphical  object  does  nothing. 

The  DETECTOR  graphical  object  supports  the  Transparency  and  Color  options. 

DETECTOR  Inputs 

To  display  a  detector  cone  coming  from  a  station  or  satellite,  highlight  an  entry  in  the  Origin 
Stations  list  and  click  the  Display  button.  The  detector  properties  can  be  adjusted  using  the 
Properties  and  Look  Dir  options.  Characteristics  can  be  created  and  saved  for  future  use  with 
the  File  option. 

Origin  Station:  The  Origin  Station  list  presents  a  list  of  stations  and  satellites  currently 

available  for  associating  with  a  detector.  To  add  a  station  to  the  Origin 
Station  list,  use  the  STATIONS  graphics  module  to  display  a  station.  To 
add  a  satellite  to  the  Origin  Station  list,  run  the  SATEE-APP  module  and 
display  a  satellite  using  the  SATEEEITE  graphics  module. 

Properties:  The  Properties  switch  accesses  to  the  following  detector  cone  properties. 

View  Angle:  The  View  Angle  slider  and  text  box  are  used  to  set  the 

width  in  degrees  of  the  detector  cone. 

Solid:  The  Solid  toggle  button  is  used  to  display  solid  detector 

cones.  By  default  only  the  silhouette  edges  of  the 
detector  cone  are  displayed. 

Took  Dir:  The  default  look  direction  for  a  detector  cone  coming  from  a  satellite  and 

a  station  is  toward  the  nadir  and  the  zenith,  respectively.  The  Look  Dir 
switch  provides  access  to  the  following  detector  look  direction  options: 

Eixed:  The  Fixed  switch  reveals  slider  and  equivalent  text 

fields  used  to  adjust  the  Pitch  and  Azimuth  direction. 

Pitch:  Eor  a  satellite  detector  with  azimuth  angle 

equal  to  zero  degrees,  a  90  (-90)  degree 
pitch  angle  is  parallel  (anti-parallel)  to  the 
satellite  geographic  velocity  vector.  Eor  a 
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station  detector,  a  90  (-90)  degree  pitch 
angle  points  the  cone  northward 
(southward). 

Azimuth:  For  a  satellite  detector  with  a  90  degree 
pitch  angle,  a  zero  degree  azimuth  angle 
aligns  the  detector  cone  with  the  satellite 
geographic  velocity  vector.  For  a  station 
detector  with  a  90  degree  pitch  angle,  a  zero 
degree  azimuth  angle  directs  the  detector 
cone  northward. 

Tracking:  The  Tracking  switch  reveals  a  Track  Station  list.  The 

detector  cone  look  direction  will  be  fixed  on  a  station  or 
satellite  if  an  entry  is  highlighted.  The  detector  cone 
will  only  remain  visible  while  there  is  an  open  direct 
line-of-sight  between  the  Origin  Station  and  the  Track 
Station  objects.  To  add  a  station  to  the  Track  Station 
list,  use  the  STATIONS  graphics  module  to  display  a 
station.  To  add  a  satellite  to  the  Track  Station  list,  run 
the  SATEL-APP  module  and  display  a  satellite  using 
the  SATELLITE  graphics  module. 

Eile:  The  File  option  allows  the  user  to  display  pre-defmed  detectors  as  well  as 

define  new  detectors  and  edit  the  list  of  saved  detector  descriptions.  The 
save  detector  configurations  can  only  be  used  when  the  Look  Dir:  Fixed 
option  is  selected  (see  above).  The  following  input  options  are  provided: 

Detector  Views:  The  Detector  Views  list  presents  a  list  of  detector  cones 
currently  available  for  associating  with  the  station  or 
satellite  highlighted  in  the  Origin  Station  list.  To 
display  one  of  these  detectors,  highlight  an  entry  in  the 
list  and  click  on  the  Display  button.  To  save  the  current 
detector  setting  as  a  new  entry  in  this  list,  use  the  Name 
and  Save  features  detailed  below. 

Name:  The  Name  text  field  represents  the  name  to  be  assigned 

to  a  new  detector  entry  that  will  appear  in  the  Detector 
Views  list.  The  current  Properties  and  Look  Dir  settings 
will  be  associated  with  this  name  when  saved. 

Save:  The  Save  button  adds  a  detector  called  Name  to  the 

Detector  Views  list.  The  characteristics  to  be  associated 
with  the  new  detector  are  those  currently  appearing  in 
the  Properties  and  Look  Dir  settings. 

Delete:  The  Delete  button  allows  the  user  to  remove  a  detector  from  the  Detector  Views  list.  To 
remove  a  detector,  highlight  its  name  in  the  Detector  Views  list  and  click  on  the  Delete  button. 
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DMSP 


The  DMSP  graphical  object  is  used  to  view  1-D  plots  and  2-D  spectral  plots  of  DMSP  SSJ/4  &  5 
and  SSI/ES  sensor  data  that  were  previously  prepared  using  the  DMSP  Data  Module. 

The  DMSP  graphical  object  rendering  is  dependent  on  the  window  type. 

In  a  ID  window,  the  DMSP  graphical  object  will  display  a  set  of  DMSP  data  derived  quantities 
as  a  function  of  time. 

In  a  2D  window,  the  DMSP  graphical  object  does  nothing 
In  a  3D  window,  the  DMSP  graphical  object  does  nothing. 

In  a  Heliospace  window,  DMSP  graphical  object  does  nothing. 

In  a  Spectral  window,  the  DMSP  graphical  object  displays  energy  spectrograms  of  precipitating 
electron  and  ion  particle  counts  and  flux  as  a  function  of  time  for  a  single  DMSP  satellite  orbit. 

The  DMSP  graphical  object  supports  the  Color  Map  option. 

DMSP  Inputs 

Before  using  this  DMSP  graphics  module,  a  set  of  data  files  for  a  DMSP  satellite  orbit  must  first 
be  processed  using  the  DMSP  Data  Module.  The  ID  Plot  quantities  described  below  are  viewed 
using  a  ID  window  (e.g.,  select  the  Viewport  menu,  then  the  option  Projection  and  sub-option 
One  D).  The  Counts  and  Flux  quantities  accessible  via  the  Data  button  are  viewed  using  a 
Spectral  window  (e.g.,  select  the  Viewport  menu,  then  the  options  Projection  and  sub-option 
Spectral).  See  “DMSP  Precipitating  Particles:  Data  Versus  Climatology”  in  the  EXAMPLES 
section  of  this  manual  for  a  demonstration  of  basic  module  functions. 

Data:  The  Data  option  button  is  used  to  select  either  Counts  in  units  of 

counts/observation  or  Flux  in  units  of  log[#/(cm2-s-sr)]  as  the  quantity  to 
be  viewed  in  the  2-D  Spectral  window.  If  no  options  appear,  then  the  user 
must  use  the  DMSP  Data  Module  to  process  an  orbit  of  data.  Checking  the 
Display  option  while  a  Spectral  window  is  active  will  produce  a  2D 
energy  versus  time  plot  in  the  Spectral  window. 

Eq.  Edge:  If  the  equatorward  edge  boundary  of  the  diffuse  auroral  precipitation  was 

contained  in  the  DMSP  data  files  processed,  then  selecting  this  option  will 
cause  the  boundary  locations  to  appear  in  the  Spectral  plot. 

ID  Plot:  The  ID  Plot  options  listed  here  are  quantities  to  be  viewed  in  a  1-D 

window.  Checking  the  Display  option  while  a  1-D  window  is  active  will 
produce  a  1-D  plot  of  the  selected  quantity  versus  time  in  that  window.  If 
no  plot  appears,  then  the  user  must  use  the  DMSP  Data  Module  to  process 
an  orbit  of  data. 

None:  No  data  has  been  selected  for  viewing  in  a  1-D  window. 

Data  Probe  0  Selecting  the  Data  Probe  0  option  will  cause  a  line  to 
be  drawn  in  the  spectral  plot  window  and  the  spectral 
data  along  that  line  will  appear  in  the  1-D  plot  window. 
If  this  option  is  selected  then  the,  X  Axis,  Y  Axis,  and 
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Position  options  described  below  control  the  orientation 
and  placement  of  the  data  probe  line. 

lEF-E,  lEE-P  Integral  energy  flux  of  electrons  (lEF-E)  or  protons 
(lEF-P)  will  be  plotted  by  selecting  these  options. 

INE-E,  INE-P:  Integral  number  flux  of  electrons  (INF-E)  or  protons 

(INF-P)  will  be  plotted  by  selecting  these  options. 

AE-E,  AE-P;  Average  energy  of  electrons  (AE-E)  or  protons  (AE-P) 
will  be  plotted  by  selecting  these  options. 

Bx,  By,  Bz:  The  magnetic  field  components  (in  nT)  are  measured 

down  along  the  local  vertical  direction  (Bx),  along  the 
forward  direction  (By;  perpendicular  to  Bx),  and 
“vertical”  (Bz,  perpendicular  to  both  Bx  and  By)  to  the 
spacecraft  orbit. 

V  Hori,  V  Vert:  Ion  drift  velocities  (m/s)  in  the  horizontal  {V Hori)  and 
vertical  {V  Vert)  direction  will  be  plotted  by  selecting 
these  options. 

The  following  BMode  options  apply  only  to  J5  data  available  on  DMSP 
El 6  and  future  missions. 

BMode:IEE-E, 

BMode:IEE-P:  Eor  the  BMode  pitch-angle  selected  in  the  DMSP  Data 

Module,  these  options  result  in  plots  of  the  integral 
energy  flux  of  electrons  (lEF-E)  or  protons  (lEF-P). 

BMode:INF-E, 

BMode:  INF-P:  For  the  BMode  pitch-angle  selected  in  the  DMSP  Data 
Module,  these  options  result  in  plots  of  the  integral 
number  flux  of  electrons  (INF-E)  or  protons  (INF-P). 

BMode:AE-E, 

BMode:  AE-P:  For  the  BMode  pitch-angle  selected  in  the  DMSP  Data 
Module,  these  options  result  in  plots  of  the  average 
energy  of  electrons  (AE-E)  or  protons  (AE-P). 

X  Axis,  Y  Axis:  If  the  ID  Plot  option  called  Data  Probe  0  is  selected,  then  selecting  the  X 

Axis  or  Y  Axis  option  determines  whether  the  data  probe  line  will  run 
vertically  or  horizontally,  respectively,  through  the  spectral  plot.  If  the 
Data  Probe  0  option  is  not  selected,  then  these  options  do  nothing. 

Position:  If  the  ID  Plot  option  called  Data  Probe  0  is  selected,  then  the  Position 

slider  controls  the  vertical  (if  Das  X Axis  option  was  selected)  or  horizontal 
(if  the  Y  Axis  option  was  selected)  location  in  the  spectral  plot  of  the  line 
defining  the  quantity  to  be  assigned  to  the  Data  Probe  0  option.  The  data 
to  appear  in  the  1  -D  window  will  then  represent  the  spectral  plot  content 
along  the  line.  If  the  Data  Probe  0  option  is  not  selected,  then  this  option 
does  nothing. 
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Type: 

Thickness: 
X  Axis: 


Y-Axis: 


The  Type  options  are  used  to  select  how  the  linear  data  are  plotted,  i.e.,  as 
discrete  points  {Point),  a  solid  line  {Line),  or  stippled  line  {Stipple  1  and 
Stipple  2). 

The  Thickness  slider  controls  the  width  of  plotted  points  and  lines. 

Displayed  XyfxA  features  are  controlled  by  the  following  options: 

Enabled:  The  Enabled  check  box  controls  the  display  of  axis 

labels. 

Grid:  The  Grid  check  box  places  grid  lines  at  axis  tic  mark 

locations. 


Min,  Max: 


Auto: 


Format: 


The  Min  and  Max  text  boxes  are  used  to  control  the 
range  of  values  plotted.  After  editing  either  value,  the 
plot  will  update  when  the  cursor  is  placed  in  any  one  of 
the  other  text  boxes  in  the  environment  window. 

The  Auto  button  adjacent  to  the  Min  and  Max  text  boxes 
automatically  resets  the  plot  range  to  the  minimum  and 
maximum  values  of  the  data  set. 

The  Format  text  box  determines  the  format  of  the  tic 
mark  labels.  “C”-like  format  statements  are  accepted, 
e.g.,  “%5.2f  ’  will  label  the  tics  using  floating  point 
numbers  with  two  decimal  places.  Substitute  an  “e” 
for  “f  ’  and  exponential  formatting  will  be  used.  After 
editing  a  Format  text  box,  the  display  will  update  when 
the  cursor  is  placed  in  any  other  text  box  in  the 
environment  window. 


Num  Tics:  The  Num  Tics  text  box  controls  the  number  of  labels 

and  tic  marks  along  the  axis.  Update  by  placing  the 
cursor  in  another  text  box. 


The  Y  Axis  options  are  the  same  as  the  X Axis  options  described  above 
with  the  following  additional  capabilities: 

Side:Left,  Right:  The  Left  and  Right  buttons  determine  the  display  side  of 
the  axis  labels. 

Log:  The  Log  check  box  activates  the  use  of  a  log  base  10 

scale.  When  applied  to  number  values  less  than  or  equal 
to  zero,  the  Log  function  will  display  a  “-6”  on  the  log 
scale. 
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EARTH 


The  EARTH  graphical  object  can  be  used  to  plot  a  representation  of  the  Earth  as  well  as  surface 
grids,  the  day/night  terminator,  and  political  boundaries,  and  rivers.  The  color  of  all  surface 
features  is  adjustable.  Rendering  of  the  EARTH  graphical  object  is  dependent  on  the  window 
type. 

In  a  ID  window,  the  EARTH  graphical  object  does  nothing. 

In  a  2D  window,  the  EARTH  graphical  object  plots  outlines  or  solid  representations  of  the 
Earth’s  continents.  The  horizontal  axis  is  longitude;  the  vertical  axis  is  latitude. 

In  a  3D  window,  the  EARTH  graphical  object  plots  a  sphere  with  either  outlines  or  filled 
representations  of  the  Earth’s  continents. 

In  a  Heliospace  window,  EARTH  does  nothing. 

In  a  Spectral  window,  EARTH  does  nothing. 

The  EARTH  graphical  object  supports  the  Clipping,  Lights,  Material,  and  Color  options. 


EARTH  Inputs 

Outline  Detail: 


Grid  Options: 


Resolution: 


Detail  Eevel: 


The  user  can  select  any  of  the  buttons  in  this  section  to  determine  how  the 
Earth  is  drawn.  The  choices  are: 

Textured:  Draw  the  continents  filled  with  a  textured  map. 

Geographic  Bndys:  Draw  white  outlines  of  geographic  boundary  features. 
Political  Bndys:  Draw  yellow  outlines  of  political  boundaries. 

Rivers:  Draw  green  outlines  of  rivers. 

The  selections  within  this  section  allow  the  user  to  place  several  different 
grids  on  the  representation  of  the  Earth.  The  choices  are: 

Eat/Eon  Grid:  Render  a  grid  showing  geographic  latitude  and 

longitude.  The  default  resolution  is  10“. 

Mag  Dipole  Grid:  Render  a  grid  showing  magnetic  latitude  and  longitude 
of  the  tilted  dipole  field.  The  default  resolution  is  10°. 

CGM  Grid:  Render  a  grid  showing  magnetic  latitude  and  longitude 

of  the  CGM  field.  The  default  resolution  is  10°' 

Terminator:  Draw  a  line  at  the  terminator  using  the  global  UT. 

These  up/down  arrows  determine  the  resolution  with  which  outline 
features  are  rendered  and  rendering  becomes  more  detailed  as  the 
resolution  is  decreased.  The  Resolution  setting  only  affects  outlined 
geographic  boundaries,  political  boundaries,  and  rivers. 

The  database  from  which  the  outline  features  are  rendered  on  the  Earth  is 
divided  by  “detail  level”.  As  Detail  Level  is  increased,  more  minor 
geographic  features  are  included  on  the  plot.  Eor  example,  with 
geographic  boundaries,  a  detail  level  of  one  will  render  continents  and 
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“major”  islands.  Increasing  the  detail  level  will  inerease  the  number  of 
“minor”  islands  and  other  small  geographie  features  ineluded  in  the 
output.  These  up/down  arrows  only  affeet  outlined  geographie  boundaries 
and  rivers. 
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EMITTER 


The  EMITTER  graphical  object  is  used  to  view  an  emitter,  such  as  a  radar  fan,  located  at  a 
station  or  in  orbit  on  a  satellite.  The  stations  and  satellites  to  be  associated  with  an  EMITTER 
must  have  been  displayed  previously  using  the  STATION  graphics  module  and  the  SATEE-APP 
and  SATEEEITE  modules,  respectively. 

The  EMITTER  graphical  object  rendering  is  dependent  on  the  window  type. 

In  a  ID  window,  the  EMITTER  graphical  object  does  nothing. 

In  a  2D  window,  the  EMITTER  graphical  object  does  nothing. 

In  a  3D  window,  the  EMITTER  will  display  the  emitter  fan  in  three-dimensional  space  around 
the  Earth. 

In  a  Heliospace  window,  EMITTER  does  nothing. 

In  a  Spectral  window,  EMITTER  does  nothing. 

The  EMITTER  graphical  object  supports  the  Transparency  and  Color  options. 

EMITTER  Inputs 

To  display  an  emitter  fan  coming  from  a  station  or  satellite,  highlight  an  entry  in  the  Origin 
Station  list  and  click  the  Display  button.  The  EMITTER  properties  can  be  adjusted  using  the 
Properties  and  Look  Dir  options.  EMITTER  characteristics  can  be  created  and  saved  to  file  for 
future  use  with  the  File  option. 

Origin  Station:  The  Origin  Station  list  presents  a  list  of  stations  and  satellites  currently 

available  for  associating  with  an  EMITTER.  To  add  a  station  to  the  Origin 
Station  list,  use  the  STATIONS  graphics  module  to  display  a  station.  To 
add  a  satellite  to  the  Origin  Station  list,  run  the  SATEE-APP  module  and 
display  a  satellite  using  the  SATEEEITE  graphics  module. 

Properties:  The  Properties  switch  provides  access  to  the  following  EMITTER  fan 

properties. 

View  Horizontal:  The  View  Horizontal  slider  and  text  box  are  used  to  set 
horizontal  width  in  degrees  of  the  EMITTER  fan. 

View  Vertical:  The  View  Vertical  slider  and  text  box  are  used  to  set  the 
vertical  width  in  degrees  of  the  EMITTER  fan. 

View  Range(km):  The  View  Range  slider  and  text  box  are  used  to  set  the 
range  in  kilometers  of  the  EMITTER  fan. 

Solid:  The  Solid  toggle  button  is  used  to  display  solid 

EMITTER  cones.  By  default  only  the  silhouette  edges 
of  the  EMITTER  cone  are  displayed. 

Eook  Dir:  The  default  look  direction  for  an  EMITTER  cone  coming  from  a  satellite 

and  a  station  is  toward  the  nadir  and  the  zenith,  respectively.  The  Look  Dir 
switch  provides  access  to  the  following  EMITTER  look  direction  options: 
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File: 


Fixed:  The  Fixed  switeh  reveals  slider  and  equivalent  text 

fields  used  to  adjust  the  Pitch  and  Azimuth  direetion. 

Piteh:  For  a  satellite  EMITTER  with  azimuth  angle 

equal  to  zero  degrees,  a  90  (-90)  degree 
piteh  angle  is  parallel  (anti-parallel)  to  the 
satellite  veloeity  vector,  respectively.  Eor  a 
station  EMITTER,  a  0  degree  pitch  angle 
points  the  cone  northward  tangent  to  the 
Earth’s  surface.  Positive  (negative)  pitch 
angles  direct  the  fan  below  (above)  the 
horizon. 

Azimuth:  for  a  satellite  EMITTER  with  a  90  degree 
pitch  angle,  a  zero  degree  azimuth  angle 
aligns  the  EMITTER  cone  with  the  satellite 
velocity  vector.  Eor  a  station  EMITTER 
with  a  0  degree  pitch  angle,  a  zero  degree 
azimuth  angle  directs  the  EMITTER  cone 
northward  with  positive  (negative)  azimuth 
angles  rotating  the  fan  eastward  (westward). 

Tracking:  The  Tracking  switch  reveals  a  Track  Station  list.  The 

EMITTER  fan  look  direction  will  be  fixed  on  a  station 
or  satellite  if  an  entry  is  highlighted.  The  EMITTER 
cone  will  only  remain  visible  while  there  is  an  open 
direct  line-of-sight  between  the  Origin  Station  and  the 
Track  Station  objects.  To  add  a  station  to  the  Track 
Station  list,  use  the  STATIONS  graphics  module  to 
display  a  station.  To  add  a  satellite  to  the  Track  Station 
list,  run  the  SATEE-APP  module  and  display  a  satellite 
using  the  SATEEEITE  graphics  module. 

The  File  option  allows  the  user  to  display  pre-defined  EMITTERS  as  well 
as  define  new  EMITTERS  and  edit  the  list  of  saved  EMITTER 
descriptions.  The  saved  EMITTER  configurations  can  only  be  used  when 
the  Look  Dir:  Fixed  option  is  selected  (see  above).  The  following  input 
options  are  provided: 

EMITTER  Views:  The  EMITTER  Views  list  presents  a  list  of  EMITTER 
cones  currently  available  for  associating  with  the 
station  or  satellite  highlighted  in  the  Origin  Station  list. 
To  display  one  of  these  EMITTERS,  highlight  an  entry 
in  the  list  and  click  on  the  Display  button.  To  save  the 
current  EMITTER  setting  as  a  new  entry  in  this  list  use 
the  Name  and  Save  features  detailed  below. 

Name:  The  Name  text  field  represents  the  name  to  be  assigned 

to  a  new  EMITTER  entry  that  will  appear  in  the 
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Save: 


Delete: 


EMITTER  Views  list.  The  eurrent  Properties  and  Look 
Dir  settings  will  be  associated  with  this  name  when 
saved. 

The  Save  button  adds  an  EMITTER  called  Name  to  the 
EMITTER  Views  list.  The  characteristics  to  be 
associated  with  the  new  EMITTER  are  those  currently 
appearing  in  the  Properties  and  Look  Dir  settings. 

The  Delete  button  allows  the  user  to  remove  an 
EMITTER  from  the  EMITTER  Views  list.  To  remove 
an  EMITTER,  highlight  its  name  in  the  EMITTER 
Views  list  and  click  on  the  Delete  button. 
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FIELD-LINES 


The  FIELD-LINES  graphical  object  is  used  to  produce  a  depiction  of  magnetic  field  lines  from 
the  geomagnetic  field  model  applications  BLIELD-APP  and  BEOOTPRINT-APP  and  from  the 
equatorial  boundary  produced  by  the  AURORA  science  module. 

The  PILED-LINES  graphical  object  rendering  is  dependent  on  the  window  type. 

In  a  ID  window,  the  PIELD-LINES  graphical  object  does  nothing. 

In  a  2D  window,  PIELD-LINES  will  project  the  lines  onto  a  2D  grid  of  longitude  (horizontal) 
and  latitude  (vertical). 

In  a  3D  window,  PIELD-LINES  will  display  the  lines  in  three-dimensional  space  around  the 
Earth. 

In  a  Heliospace  window,  PIELD-LINES  does  nothing. 

In  a  Spectral  window,  PIELD-LINES  does  nothing. 

The  PIELD-LINES  graphical  object  supports  the  Clipping,  Transparency,  Lights,  Material,  and 
Color  options. 


FIELD-LINES  Inputs 

Data:  The  Data  option  menu  is  used  to  select  the  main  data  set  and  the  type  of 

field  lines  to  be  displayed.  This  option  must  be  set  before  rendering  is 
allowed.  The  option  menu  contains  a  list  of  valid,  previously  generated 
BFIELD-APP,  BFOOTPRINT-APP,  and  AURORA  items. 

Plot  Type:  The  plot  type  field  determines  how  the  PIELD-LINES  should  be  rendered. 

Pield  Lines:  Render  the  PIELD-LINES  as  separate  field  lines. 

Pilled  Surface:  Render  the  PIELD-LINES  as  a  surface  connecting  the 
field  lines. 


Line  Width:  These  up/down  arrows  are  used  to  select  the  width  of  the  field  lines  in  the 

display  from  1  (thinnest)  to  5  (thickest). 

Line  Type:Smooth  This  option  renders  smooth  depictions  of  the  field  lines. 
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GLOBAL  INPUTS 


The  GLOBAL  INPUTS  graphical  object  is  used  to  produce  a  line  plot  of  the  global  input  data 
values  as  a  function  of  time.  For  dynamic  runs,  the  time  range  is  determined  by  the  Start  and 
End  times  entered  at  the  top  of  the  Environment  Window.  Eor  static  runs,  the  time  range  is  fixed 
equal  to  24-hours  beginning  with  the  Start  time. 

The  GEOBAL  INPUTS  graphical  object  rendering  is  dependent  on  the  window  type. 

In  a  ID  window,  the  GEOBAE  INPUTS  graphical  object  produces  a  line  plot. 

In  a  2D  window,  GEOBAL  INPUTS  does  nothing. 

In  a  3D  window,  GLOBAL  INPUTS  does  nothing. 

In  a  Heliospace  window,  GLOBAL  INPUTS  does  nothing. 

In  a  Spectral  window,  GLOBAL  INPUTS  does  nothing. 

The  GLOBAL  INPUTS  graphical  object  supports  the  Transparency  and  Color  options. 

GLOBAL  INPUTS  Inputs 

Value:  The  Value  options  represent  global  input  parameters  available  for  plotting. 

The  choices  include  magnetic  activity  indices  Kp,  Sum  Kp,  Ap,  Apl5,  as 
well  as  the  sunspot  number  SSN,  FIO.  7  cm  solar  radiation  flux,  the 
geomagnetic  index  Dst,  and  the  equatorward  edge  of  the  diffuse  aurora  at 
midnight  {Eq  Edge).  Eor  details  about  these  parameters  please  refer  to  the 
Global  Parameters  section  of  this  user’s  manual.  In  dynamic  mode,  the 
text  version  of  these  values  can  be  edited  directly  using  the  Globals 
pulldown  menu. 

Type:  The  Type  options  are  used  to  select  how  the  linear  data  are  plotted,  i.e.,  as 

discrete  points  {Point),  a  solid  line  {Line),  or  stippled  line  {Stipple  1  and 
Stipple  2). 

Thickness:  The  Thickness  slider  controls  the  width  of  plotted  points  and  lines. 

X  Axis:  Displayed  AHxA  features  are  controlled  by  the  following  options: 

Enabled:  The  Enabled  check  box  controls  the  display  of  axis 

labels. 

Grid:  The  Grid  check  box  places  grid  lines  at  axis  tic  mark 

locations. 

Min,  Max:  The  Min  and  Max  text  boxes  are  used  to  control  the 

range  of  values  plotted.  After  editing  either  value,  the 
plot  will  update  when  the  cursor  is  placed  in  any  one  of 
the  other  text  boxes  in  the  environment  window. 

Auto:  The  Auto  button  adjacent  to  the  Min  and  Max  text  boxes 

automatically  resets  the  plot  range  to  the  minimum  and 
maximum  values  of  the  data  set. 
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Format: 


The  Format  text  box  determines  the  format  of  the  tie 
mark  labels.  “C”-like  format  statements  are  aceepted, 
e.g.,  “%5.2f  ’  will  label  the  tics  using  floating  point 
numbers  with  two  decimal  places.  Substitute  an  “e” 
for  “f  ’  and  exponential  formatting  will  be  used.  After 
editing  a  Format  text  box,  the  display  will  update  when 
the  cursor  is  placed  in  any  other  text  box  in  the 
environment  window. 

Num  Tics:  The  Num  Tics  text  box  controls  the  number  of  labels 

and  tic  marks  along  the  axis.  Update  by  placing  the 
cursor  in  another  text  box. 

Y-Axis:  The  Y Axis  options  are  the  same  as  the,  X Axis  options  described  above 

with  the  following  additional  capabilities: 

Side:  Left,  Right:  The  Left  and  Right  buttons  determine  the  display  side  of 
the  axis  labels. 

Log:  The  Log  check  box  activates  the  use  of  a  log  base  10 

scale.  When  applied  to  number  values  less  than  or  equal 
to  zero,  the  Log  function  will  display  a  “-6”  on  the  log 
scale. 

Save:  The  Save  button  activates  a  Save  As  popup  window  used  to  save  the  1-D 

displayed  data  to  a  text  file.  Designated  file  names  should  end  with  “.txt” 
for  viewing  convenience. 
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GRID 


The  GRID  graphical  object  can  be  used  to  draw  the  calculation  grid  for  the  dataset.  Rendering  of 

the  GRID  graphical  object  is  dependent  on  the  window  type. 

In  a  ID  window,  the  GRID  graphical  object  does  nothing. 

In  a  2D  window,  the  GRID  graphical  object  plots  the  grid  of  the  dataset  with  the  horizontal  axis 

representing  longitude  and  the  vertical  axis  representing  latitude. 

In  a  3D  window,  the  GRID  graphical  object  draws  the  grid  of  the  data  set  in  three-dimensional 

space. 

In  a  Heliospace  window,  GRID  does  nothing. 

In  a  Spectral  window,  GRID  does  nothing. 

The  GRID  graphical  object  supports  the  Color  option. 

GRID  Inputs 

Data:  The  Data  option  menu  is  used  to  select  the  main  data  set  for  which  the 

GRID  is  to  be  plotted.  This  option  must  be  set  to  a  data  set  before 
rendering  is  allowed.  The  option  menu  contains  a  list  of  valid,  previously 
run  science,  data,  and  application  data  sets. 

Plot  as:  This  input  is  used  to  specify  whether  the  grid  should  be  plotted  as  a  series 

of  Points,  one  to  a  grid  vertex,  or  as  a  series  of  connected  Lines. 
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lONSCINT-G 


The  lONSCINT-G  graphical  object  is  used  to  view  GPS  scintillation  scenarios  for  fixed  receiver 
platforms  generated  by  the  lONSCINT-G  Science  Module.  Results  can  be  viewed  in  1-D  plots  of 
scintillation  vs.  azimuth  or  elevation  and  2-D  all-sky  scintillation  maps  in  azimuth  and  elevation. 

The  lONSCINT-G  graphical  object  rendering  is  dependent  on  the  window  type. 

In  a  ID  window,  the  lONSCINT-G  graphical  object  will  display  a  set  of  scintillation  data  (the  S4 
index)  as  a  function  of  either  elevation  or  azimuth  angle. 

In  a  2D  window,  the  lONSCINT-G  graphical  object  does  nothing 

In  a  3D  window,  the  lONSCINT-G  graphical  object  does  nothing. 

In  a  Heliospace  window,  lONSCINT-G  graphical  object  does  nothing. 

In  a  Spectral  window,  the  lONSCINT-G  graphical  object  displays  a  2D  all-sky  plot  representing 
the  view  from  a  fixed  platform  of  the  S4  index  as  a  function  of  elevation  and  azimuth  angle  for  a 
given  time. 

The  lONSCINT-G  graphical  object  supports  the  Color  Map  and  Data  Map  options. 

lONSCINT-G  Inputs 

The  lONSCINT-G  Science  Module  must  be  run  before  using  this  lONSCINT-G  graphics 
module.  The  Data  Probe  quantities  described  below  are  viewed  using  a  ID  window  (e.g.,  select 
the  Viewport  menu,  then  the  option  Projection  and  sub-option  One  D).  The  S4Index  output 
accessible  via  the  Data  button  are  viewed  using  a  Spectral  window  (e.g.,  select  the  Viewport 
menu,  then  the  options  Projection  and  sub-option  Spectral). 

Data:  The  Data  option  button  is  used  to  select  the  scintillation  output  (i.e.,  the 

S4  index)  to  be  viewed  in  active  1-D  and/or  2-D  Spectral  windows.  If  no 
options  appear,  then  the  user  must  run  the  lONSCINT-G  Science  Module. 
Checking  the  Display  option  while  a  Spectral  window  is  active  will 
produce  a  2D  all-sky  plot  of  the  S4  index  as  a  function  of  elevation 
(actually  sin(elevation  angle)  and  azimuth  angle  (0°  for  North,  90°  for 
East,  etc). 

Data  Probe:  Eight  different  Data  Probes  can  be  activated  and  viewed  by  checking  the 

Enabled  box  while  the  corresponding  probe  number  (0-7)  is  showing.  If  an 
all-sky  plot  is  visible  in  an  active  spectral  window,  then  a  data  probe  line 
will  be  drawn  in  it  and  the  data  along  that  line  can  also  be  displayed  in  an 
active  1-D  window.  The  Sin(elev),  Azimuth,  and  Position  options 
described  below  control  the  orientation  and  placement  of  the  data  probe.  If 
no  Data  Probe  is  Enabled,  then  the  following  options  do  nothing. 

Sin(elev),  Azimuth:  Selecting  one  of  these  options  to  determine  if  the  data  probe  appears  in  the 
spectral  window  as  a  circle  of  constant  Sin(elev)  or  a  radial  line  of 
constant  Azimuth. 
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Position: 


The  Position  slider  eontrols  the  value  of  Sin(elev)  or  Azimuth  assoeiated 
with  the  Data  Probe. 


ID  Options 

Type: 


Thickness: 
X  Axis: 


Y-Axis: 


The  Type  options  are  used  to  select  how  the  linear  data  are  plotted,  i.e.,  as 
discrete  points  {Point),  a  solid  line  {Line),  or  stippled  line  {Stipple  1  and 
Stipple  2). 

The  Thickness  slider  controls  the  width  of  plotted  points  and  lines. 

Displayed  XyfxA  features  are  controlled  by  the  following  options: 

Enabled:  The  Enabled  check  box  controls  the  display  of  axis 

labels. 

Grid:  The  Grid  check  box  places  grid  lines  at  axis  tic  mark 

locations. 


Min,  Max: 


Auto: 


Format: 


The  Min  and  Max  text  boxes  are  used  to  control  the 
range  of  values  plotted.  After  editing  either  value,  the 
plot  will  update  when  the  cursor  is  placed  in  any  one  of 
the  other  text  boxes  in  the  environment  window. 

The  Auto  button  adjacent  to  the  Min  and  Max  text  boxes 
automatically  resets  the  plot  range  to  the  minimum  and 
maximum  values  of  the  data  set. 

The  Format  text  box  determines  the  format  of  the  tic 
mark  labels.  “C”-like  format  statements  are  accepted, 
e.g.,  “%5.2f  ’  will  label  the  tics  using  floating  point 
numbers  with  two  decimal  places.  Substitute  an  “e” 
for  “f  ’  and  exponential  formatting  will  be  used.  After 
editing  a  Format  text  box,  the  display  will  update  when 
the  cursor  is  placed  in  any  other  text  box  in  the 
environment  window. 


Num  Tics:  The  Num  Tics  text  box  controls  the  number  of  labels 

and  tic  marks  along  the  axis.  Update  by  placing  the 
cursor  in  another  text  box. 


The  Y  Axis  options  are  the  same  as  the  X Axis  options  described  above 
with  the  following  additional  capabilities: 

Side:Left,  Right:  The  Left  and  Right  buttons  determine  the  display  side  of 
the  axis  labels. 

Log:  The  Log  check  box  activates  the  use  of  a  log  base  10 

scale.  When  applied  to  number  values  less  than  or  equal 
to  zero,  the  Log  function  will  display  a  “-13”  on  the  log 
scale. 
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ISOCONTOUR 


The  ISOCONTOUR  graphical  object  is  used  to  produce  a  surface  of  constant  value  through  a 
three-dimensional  data  set. 

The  ISOCONTOUR  graphical  object  rendering  is  dependent  on  the  window  type. 

In  a  ID  window,  the  ISOCONTOUR  graphical  object  does  nothing. 

In  a  2D  window,  ISOCONTOUR  will  project  the  outline  of  the  constant  value  surface  onto  a  2D 
grid  representing  longitude  (horizontal)  and  latitude  (vertical). 

In  a  3D  window,  ISOCONTOUR  will  display  the  constant  value  surface  through  the  data  set  in 
three-dimensional  space  around  the  Earth. 

In  a  Heliospace  window,  ISOCONTOUR  does  nothing. 

In  a  Spectral  window,  ISOCONTOUR  does  nothing. 

The  ISOCONTOUR  graphical  object  supports  the  Clipping,  Transparency,  Lights,  Material, 
Color  Map,  and  Data  Map  options. 

ISOCONTOUR  Inputs 

Data:  The  Data  option  menu  is  used  to  select  the  main  data  set  the 

ISOCONTOUR  is  to  be  taken  through.  This  option  must  be  set  before 
rendering  is  allowed.  The  option  menu  contains  a  list  of  valid,  previously 
run  science,  data,  and  application  data  sets. 

Contour  Value:  The  Contour  Value  slider  input  determines  the  value  of  the  constant 

surface.  The  values  will  range  from  the  minimum  to  the  maximum  for  the  chosen  data  set.  The 
numbers  below  the  slider  represents  the  relative  and  actual  data  values. 
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LINK 


The  LINK  graphical  object  is  used  to  view  a  line-of-sight  link  between  stations  and  satellites  or 
between  separate  satellites.  The  link  can  be  colored  with  interpolated  values  from  a  selected  data 
set.  All  stations  to  be  used  must  have  been  displayed  previously  using  the  STATIONS  graphics 
module.  All  satellites  to  be  used  must  have  been  produced  previously  using  the  SATEL-APP 
application  module  and  displayed  using  the  SATELLITE  graphics  module. 

The  LINK  graphical  object  rendering  is  dependent  on  the  window  type. 

In  a  ID  window,  the  LINK  graphical  object  produces  a  line  plot  of  data  values  colored  according 
to  the  parameter  values  along  the  link.  The  distance  between  the  link  ends  is  normalized  to  one. 

In  a  2D  window,  the  LINK  will  project  the  link  onto  a  2D  grid  representing  longitude 
(horizontal)  and  latitude  (vertical). 

In  a  3D  window,  the  LINK  will  display  the  link  in  three-dimensional  space  around  the  Earth. 

In  a  Heliospace  window,  LINK  does  nothing. 

In  a  Spectral  window,  LINK  does  nothing. 

The  LINK  graphical  object  supports  the  Color  and  Color  Map  options. 

LINK  Inputs 

Station  1,  Station  2:  The  Station  1  and  Station  2  lists  contain  all  active  station  and  satellite 

graphics  objects  that  can  be  linked.  To  view  a  link  between  two  stations, 
two  satellites,  or  between  a  station  and  a  satellite,  select  one  entry  from 
each  Station  list  and  click  the  Display  button.  To  add  a  station  to  the  lists, 
use  the  STATIONS  graphics  module  to  display  a  station.  To  add  a 
satellite  to  the  lists,  run  the  SATEL-APP  module  and  display  a  satellite 
using  the  SATELLITE  graphics  module. 

Data:  The  Data  button  is  used  to  select  a  main  data  set  for  display  along  the  link. 

The  option  menu  contains  a  list  of  valid,  previously  run  science  and 
application  data  sets.  When  a  data  set  is  selected,  the  link  should  appear 
colored,  representing  interpolated  data  values  along  the  track.  If  the  Data 
option  is  off,  the  orbit  trajectory  appears  as  a  single  color. 

Num  Steps:  The  Num  Steps  text  box  indicates  the  number  of  steps  used  in  rendering 

colors  representing  data  values  along  the  link.  The  number  of  colors  used 
to  represent  data  along  the  link  increases  with  the  value  of  Num  Steps. 

Type:  The  Type  options  are  used  to  select  how  the  linear  data  are  plotted,  i.e.,  as 

discrete  points  {Point),  a  solid  line  {Line),  or  stippled  line  {Stipple  1  and 
Stipple  2). 

Thickness:  The  Thickness  slider  controls  the  width  of  plotted  points  and  lines. 

X  Axis:  Displayed  AHxA  features  are  controlled  by  the  following  options: 

Enabled:  The  Enabled  check  box  controls  the  display  of  axis 

labels. 
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Grid;  The  Grid  check  box  places  grid  lines  at  axis  tic  mark 

locations. 

Min,  Max:  The  Min  and  Max  text  boxes  are  used  to  control  the 

range  of  values  plotted.  After  editing  either  value,  the 
plot  will  update  when  the  cursor  is  placed  in  any  one  of 
the  other  text  boxes  in  the  environment  window. 

Auto:  The  Auto  button  adjacent  to  the  Min  and  Max  text  boxes 

automatically  resets  the  plot  range  to  the  minimum  and 
maximum  values  of  the  data  set. 

Format:  The  Format  text  box  determines  the  format  of  the  tic 

mark  labels.  “C”-like  format  statements  are  accepted, 
e.g.,  “%5.2f  ’  will  label  the  tics  using  floating  point 
numbers  with  two  decimal  places.  Substitute  an  “e” 
for  “f  ’  and  exponential  formatting  will  be  used.  After 
editing  a  Format  text  box,  the  display  will  update  when 
the  cursor  is  placed  in  any  other  text  box  in  the 
environment  window. 

Num  Tics:  The  Num  Tics  text  box  controls  the  number  of  labels 

and  tic  marks  along  the  axis.  Update  by  placing  the 
cursor  in  another  text  box. 

Y-Axis:  The  Y Axis  options  are  the  same  as  the,  X Axis  options  described  above 

with  the  following  additional  capabilities: 

Side:  Left,  Right:  The  Left  and  Right  buttons  determine  the  display  side  of 
the  axis  labels. 

Log:  The  Log  check  box  activates  the  use  of  a  log  base  10 

scale.  When  applied  to  number  values  less  than  or  equal 
to  zero,  the  Log  function  will  display  a  “-6”  on  the  log 
scale. 

Save:  The  Save  button  activates  a  Save  As  popup  window  used  to  save  the  1-D 

displayed  data  to  a  text  file.  Designated  file  names  should  end  with  “.txt” 
for  viewing  convenience. 
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ORBIT-PROBE 


The  ORBIT-PROBE  graphical  object  is  used  to  produce  a  line  plot  through  a  data  set  along  an 
orbit. 

The  ORBIT-PROBE  graphical  object  rendering  is  dependent  on  the  window  type. 

In  a  ID  window,  the  ORBIT-PROBE  graphical  object  produces  a  line  plot. 

In  a  2D  window,  ORBIT-PROBE  does  nothing. 

In  a  3D  window,  ORBIT-PROBE  does  nothing. 

In  a  Heliospace  window,  ORBIT-PROBE  does  nothing. 

In  a  Spectral  window,  ORBIT-PROBE  does  nothing. 

The  ORBIT-PROBE  graphical  object  supports  the  Transparency  and  Color  options. 

ORBIT-PROBE  Inputs 

Path/ Abscissa:  This  option  menu  is  used  to  select  an  orbit  from  a  list  of  valid,  previously 

produced  orbits. 

Data/Ordinate:  This  option  menu  is  used  to  select  the  main  data  set  the  ORBIT-PROBE  is 

to  be  taken  through.  This  option  must  be  set  before  rendering  is  allowed. 
The  option  menu  contains  a  list  of  valid,  previously  run  science,  data,  and 
application  data  sets. 

Type:  The  Type  options  are  used  to  select  how  the  linear  data  are  plotted,  i.e.,  as 

discrete  points  {Point),  a  solid  line  {Line),  or  stippled  line  {Stipple  1  and 
Stipple  2). 

Thickness:  The  Thickness  slider  controls  the  width  of  plotted  points  and  lines. 

Integral:  Eor  single -valued  functions  y  =  f(x),  selecting  the  Integral  box  changes 

the  1-D  x-y  parameter  plot  to  an  integral  plot  with  value  y  =  Ef(x)dx. 

X  Axis:  Displayed  AHxA  features  are  controlled  by  the  following  options: 

Enabled:  The  Enabled  check  box  controls  the  display  of  axis 

labels. 

Grid:  The  Grid  check  box  places  grid  lines  at  axis  tic  mark 

locations. 

Min,  Max:  The  Min  and  Max  text  boxes  are  used  to  control  the 

range  of  values  plotted.  After  editing  either  value,  the 
plot  will  update  when  the  cursor  is  placed  in  any  one  of 
the  other  text  boxes  in  the  environment  window. 

Auto:  The  Auto  button  adjacent  to  the  Min  and  Max  text  boxes 

automatically  resets  the  plot  range  to  the  minimum  and 
maximum  values  of  the  data  set. 

Eog:  The  Log  check  box  activates  the  use  of  a  log  base  10 

scale.  When  applied  to  number  values  less  than  or  equal 
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to  zero,  the  Log  function  will  display  a  “-6”  on  the  log 
scale. 

Format:  The  Format  text  box  determines  the  format  of  the  tic 

mark  labels.  “C”-like  format  statements  are  accepted, 
e.g.,  “%5.2f  ’  will  label  the  tics  using  floating  point 
numbers  with  two  decimal  places.  Substitute  an  “e” 
for  “f  ’  and  exponential  formatting  will  be  used.  After 
editing  a  Format  text  box,  the  display  will  update  when 
the  cursor  is  placed  in  any  other  text  box  in  the 
environment  window. 

Num  Tics:  The  Num  Tics  text  box  controls  the  number  of  labels 

and  tic  marks  along  the  axis.  Update  by  placing  the 
cursor  in  another  text  box. 

Y-Axis:  The  Y Axis  options  are  the  same  as  the,  X Axis  options  described  above 

with  the  following  additional  capability: 

Side:  Left,  Right:  The  Left  and  Right  buttons  determine  the  display  side  of 
the  axis  labels. 

Save:  The  Save  button  activates  a  Save  As  popup  window  used  to  save  the  1-D 

displayed  data  to  a  text  file.  Designated  file  names  should  end  with  “.txt” 
for  viewing  convenience. 
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ORBIT-SLICE 


The  ORBIT-SLICE  graphical  object  is  used  to  produce  a  data  set  slice  that  contains  a  satellite 
and  the  slice  is  produced  in  a  plane  defined  relative  to  a  specified  orbit.  The  planes  are  defined 
using  the  coordinate  system  used  to  produce  the  data  set  or  are  planes  perpendicular  to  or 
containing  the  satellite  velocity  vector.  When  a  data  set  is  produced  using  spherical  coordinates, 
for  example,  the  displayed  data  can  be  “slaved”  to  the  altitude  of  the  satellite  by  selecting  the 
satellite  radius  {PO)  as  the  defining  coordinate. 

The  ORBIT-SLICE  graphical  object  rendering  is  dependent  on  the  window  type. 

In  a  ID  window,  the  ORBIT-SLICE  graphical  object  does  nothing. 

In  a  2D  window,  ORBIT-SLICE  will  project  the  slice  onto  the  Earth’s  surface.  Although 
allowed,  usually  this  is  not  meaningful  unless  a  geocentric  radius  coordinate  is  used  to  define  the 
display  slice. 

In  a  3D  window,  ORBIT-SLICE  will  display  the  slice  through  the  data  set  in  three-dimensional 
space  around  the  Earth. 

In  a  Heliospace  window,  ORBIT-SLICE  does  nothing. 

In  a  Spectral  window,  ORBIT-SLICE  does  nothing. 

The  ORBIT-SLICE  graphical  object  supports  the  options  Clipping,  Transparency,  Lights, 
Material,  Color,  Color  Map,  and  Data  Map. 

ORBIT-SLICE  Inputs 

Satellite:  The  Satellite  option  is  used  to  slave  the  position  of  the  slice  to  the  position 

of  a  satellite  along  its  orbit.  This  option  must  be  set  to  an  orbit  before 
rendering  is  allowed.  The  option  menu  contains  a  list  of  valid,  previously 
run  orbits. 

Data:  The  Data  option  menu  is  used  to  select  the  main  data  set  the  ORBIT- 

SLICE  is  to  be  taken  through.  This  option  must  be  set  to  a  data  set  before 
rendering  is  allowed.  The  option  menu  contains  a  list  of  valid,  previously 
run  science,  data,  and  application  data  sets. 

Label:  The  label  specifies  the  nature  of  the  text  written  at  the  current  position  of 

the  satellite.  The  available  labels  are: 

Sat  Name:  The  satellite  name  set  when  it  was  created. 

Rad,  Eat,  Lon:  The  satellite  position  in  spherical  coordinates. 

X,  Y,  Z:  The  satellite  position  in  Cartesian  coordinates. 

Data  Value:  The  interpolated  data  value  at  the  satellite  position. 

Time:  The  current  time  from  the  Satellite  position  (%)  slider. 

Pop  Label:  By  default,  if  a  marker  is  displayed,  it  will  be  positioned  based  on  the 

satellite’s  three-dimensional  location.  Other  objects  may  obscure  it.  If  the 
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Reference  Frame: 


Orbit  Planes: 


Display  Options: 


Pop  Label  toggle  is  on,  the  label  will  always  be  rendered  in  front  of  all 
other  objects  and  will  therefore  always  be  visible. 

The  Reference  Frame  section  determines  how  the  SATELLITE  orbit 
should  be  rendered.  The  two  coordinate  options  are  geocentric  (GEOC) 
and  Earth  centered  inertial  (ECI). 


Geocentric: 

Render  the  SATELLITE  orbit  in  geocentric  (GEOC) 
coordinates.  Since  these  coordinates  are  rigidly  attached 
to  the  spinning  Earth  and  represent  a  non-inertial  frame, 
the  trajectory  will  not  be  approximately  elliptical  in 
shape. 

Inertial: 

Render  the  SATELLITE  orbit  in  Earth  centered  inertial 
(ECI)  coordinates.  Here  the  trajectory  will  have  an 
approximately  elliptical  shape.  Note  that  the  position  of 
the  orbit  rotates  when  animation  is  selected  because  the 
inertial  orbit  plane  is  not  fixed  in  geocentric 
coordinates. 

The  Orbit  Planes  toggle  switches  determine  which  orbital  planes  are 
rendered.  The  choices  are: 

PO: 

Draws  a  coordinate  slice  at  the  satellite  position  at  a 
fixed  value  of  the  first  coordinate  of  the  system  used  to 
produce  the  data,  e.g.,  PO  is  the  radius  in  spherical 
coordinates. 

PI: 

Draws  a  coordinate  slice  at  the  satellite  position  at  a 
fixed  value  of  the  second  coordinate  of  the  system  used 
to  produce  the  data,  e.g.,  PI  is  the  latitude  in  spherical 
coordinates. 

P2: 

Draws  a  coordinate  slice  at  the  satellite  position  at  a 
fixed  value  of  the  third  coordinate  of  the  system  used  to 
produce  the  data,  e.g.,  P2  is  the  longitude  in  spherical 
coordinates. 

P3: 

Draws  a  plane  containing  the  inertial  orbital  plane  of 
the  satellite. 

P4: 

Draws  a  plane  at  the  satellite  position  that  contains  the 
satellite’s  velocity  vector  and  is  perpendicular  to  the 
inertial  orbital  plane. 

P5: 

Draws  a  plane  at  the  satellite  position  and  perpendicular 
to  the  satellite  velocity  vector. 

The  Display  Options  field  will  allow  the  ORBIT-SLICE  to  be  filled  as 
colored  or  white  contours,  filled  or  discrete.  Any  combination  of  the 
options  may  be  selected. 
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Filled:  Render  the  ORBIT-SLICE  as  solid,  filled,  eolor 

eontours. 

Grey:  If  the  grid  extends  beyond  meaningful  data 

in  the  data  set,  the  points  without  valid  data 
will  be  filled  in  as  grey. 

Contours:  Render  the  ORBIT-SLICE  as  diserete  white  lines.  The 

lines  represent  isovalues  of  the  data  evenly  spaeed 
between  the  data  minimum  and  the  data  maximum.  The 
number  of  eontours  is  determined  by  the  Number  of 
Contours  input. 

Color  The  isovalue  lines  are  eolored  aeeording  to 
the  eolor  bar  to  represent  the  magnitude  of 
the  isovalue. 

Grid:  An  outline  of  the  grid  will  be  shown  in  the  plane  of  the 

eoordinate  sliee. 

Number  of  Contours:  The  Number  of  Contours  input  slider  determines  the  number  of  eontour 

lines  to  be  plotted  between  the  data  minimum  and  the  data  maximum  if  the 
Display  Options  seleetion  is  Contours  or  Contours:  Color. 
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PLANE-SLICE 


The  PLANE-SLICE  graphical  object  is  used  to  produce  a  planar  slice  through  a  data  set.  The 
orientation  of  the  slice  is  set  by  three  user  specified  rotations.  The  PLANE-SLICE  can  be 
represented  by  filled  color  contours  or  discrete  solid  or  colored  contour  lines.  The  grid  within  the 
slice  can  also  be  represented. 

The  PLANE  SLICE  graphical  object  rendering  is  dependent  on  the  window  type. 

In  a  ID  window,  the  PLANE-SLICE  graphical  object  does  nothing. 

In  a  2D  window,  the  PLANE-SLICE  graphical  object  does  nothing. 

In  a  3D  window,  PLANE-SLICE  will  display  the  planar  slice  through  the  data  set  in  three- 
dimensional  space  around  the  Earth. 

In  a  Heliospace  window,  PLANE-SLICE  does  nothing. 

In  a  Spectral  window,  PLANE-SLICE  does  nothing. 

The  PLANE-SLICE  graphical  object  supports  the  Clipping,  Transparency,  Lights,  Material, 
Color,  Color  Map,  and  Data  Map  options. 


PLANE-SLICE  Inputs 

Data:  This  option  menu  is  used  to  select  the  main  data  set  the  PLANE-SLICE  is 

to  be  taken  through.  This  option  must  be  set  before  rendering  is  allowed. 
The  option  menu  contains  a  list  of  valid,  previously  run  science  and 
application  data  sets. 

Till:  Render  the  PLANE-SLICE  as  solid  filled  color  contours. 


Show  Gray: 
Show  Grid: 
Contours:  White 


Contours:  Color 

Rotate  X: 

Rotate  Y : 

Rotate  Z: 


If  the  grid  extends  beyond  meaningful  data  in  the  data  set,  the  points 
without  valid  data  will  be  filled  in  as  gray  if  this  option  is  turned  on. 

An  outline  of  the  grid  will  be  shown  if  this  option  is  turned  on.  The  color 
of  the  grid  lines  can  be  adjusted  using  the  Color  option. 

Render  the  PLANE-SLICE  as  discrete  white  lines.  The  lines  represent 
isovalues  of  the  data  evenly  spaced  between  the  data  minimum  and  the 
data  maximum.  The  number  of  contours  is  determined  by  the  Number  of 
Contours  slider.  The  color  of  the  contours  lines  can  be  adjusted  using  the 
Color  option. 

Similar  to  Contours:  White,  but  the  isovalue  lines  are  colored  according  to 
the  color  bar  to  represent  the  magnitude  of  the  isovalue. 

The  Rotate  X  input  slider  rotates  the  position  of  the  planar  slice  around  the 
horizontal  direction  in  the  plane  of  the  user’s  computer  screen. 

The  Rotate  Y  input  slider  rotates  the  position  of  the  planar  slice  around  the 
vertical  direction  in  the  plane  of  the  user’s  computer  screen. 

The  Rotate  Z  input  slider  rotates  the  position  of  the  planar  slice  around  the 
direction  normal  to  the  plane  of  the  user’s  computer  screen. 
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Translate; 


Number  of  Contours: 


The  Translate  input  slider  translates  the  position  of  the  planar  sliee  along 
the  direetion  perpendieular  to  the  eurrent  position  of  the  plane,  as  set  by 
the  rotation  sliders. 

The  Number  of  Contours  input  slider  determines  the  number  of  eontour 
lines  to  be  plotted  between  the  data  minimum  and  the  data  maximum  if 
one  of  the  Contour  options  is  aetivated. 
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RAY  TRACE 


The  RAY  TRACE  graphical  object  is  used  to  produce  a  depiction  of  the  ionospheric  rays  traced 
through  the  PIM  science  model  data  sets.  The  PIM  science  module  and  RAYTRACE  application 
module  must  be  run  before  this  graphics  module  can  be  used. 

The  RAY  TRACE  graphical  object  rendering  is  dependent  on  the  window  type. 

In  a  ID  window,  the  RAY  TRACE  graphical  object  does  nothing. 

In  a  2D  window,  RAY  TRACE  will  project  the  lines  onto  a  2D  grid  of  longitude  (horizontal)  and 
latitude  (vertical). 

In  a  3D  window,  RAY  TRACE  will  display  the  lines  in  three-dimensional  space  around  the 
Earth. 

In  a  Heliospace  window,  RAY  TRACE  does  nothing. 

In  a  Spectral  window,  RAY  TRACE  does  nothing. 

The  RAY  TRACE  graphical  object  supports  the  Clipping,  Lights,  and  Material  options. 

RAY  TRACE  Inputs 

Data:  The  Data  option  menu  is  used  to  select  the  main  data  set  and  the  type  of 

field  lines  to  be  displayed.  This  option  must  be  set  before  rendering  is 
allowed.  The  option  menu  contains  a  list  of  valid,  previously  generated 
RAYTRACE-APP  items. 

Plot  Type:  The  plot  type  field  determines  which  ray  features  are  displayed. 

Ray  Eines:  Render  the  ray  lines. 

Ground  Points:  Render  the  transmitter  location  and  mark  all  ground 
intersection  points  of  the  ray’s  path  with  the  Earth’s 
surface. 

Plasma  Erequency:  Render  a  2D  contour  of  the  PIM  generated  plasma 

frequency  in  the  plane  of  the  traced  rays.  If  the  Jones- 
Stephenson  3D  model  was  selected  in  RAYTRACE- 
APP  to  generate  the  rays,  then  the  alignment  of  the  rays 
and  the  contour  will  only  be  approximate. 

Eine  Width:  These  up/down  arrows  are  used  to  select  the  width  of  the  traced  ray  lines 

in  the  display  from  1  (thinnest)  to  5  (thickest). 

Eine  Type:  Smooth  Render  smoothed  depictions  of  the  traced  ray  lines. 
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SATELLITE 


The  SATELLITE  graphical  object  is  used  to  view  a  satellite  trajectory.  The  trajectory  can  be 
colored  with  interpolated  values  from  a  selected  data  set.  The  orbit  trajectory  must  have  been 
produced  previously  using  the  SATEL-APP  application  module. 

The  SATELLITE  graphical  object  rendering  is  dependent  on  the  window  type. 

In  a  ID  window,  the  SATELLITE  graphical  object  does  nothing. 

In  a  2D  window,  the  SATELLITE  will  project  the  trajectory  onto  a  2D  grid  representing 
longitude  (horizontal)  and  latitude  (vertical). 

In  a  3D  window,  the  SATELLITE  will  display  the  trajectory  in  three-dimensional  space  around 
the  Earth. 

In  a  Heliospace  window,  SATELLITE  does  nothing. 

In  a  Spectral  window,  SATELLITE  does  nothing. 

The  SATELLITE  graphical  object  supports  the  Color  option. 


SATELLITE  Inputs 

Satellite:  This  option  menu  is  used  to  select  the  SATELLITE  orbit.  This  option 

must  be  set  before  rendering  is  allowed.  The  option  menu  contains  a  list  of 
valid  orbits  produced  previously  using  the  SATEL-APP  application 
module. 

Data:  This  option  menu  is  used  to  select  a  main  data  set  for  display  along  the 

SATELLITE  trajectory.  The  option  menu  contains  a  list  of  valid, 
previously  run  science,  data,  and  application  data  sets.  When  a  data  set  is 
selected,  the  orbit  should  appear  colored,  representing  interpolated  data 
values  along  the  track.  If  the  Data  option  is  off,  the  orbit  trajectory 
appears  as  a  single  color. 

Label:  The  label  specifies  the  nature  of  the  text  written  at  the  current  position  of 

the  satellite.  The  available  labels  are: 


Sat  Name: 
Rad,  Eat,  Lon: 
X,  Y,  Z: 

Data  Value: 
Time: 


The  satellite  name  set  when  it  was  created. 

The  satellite  position  in  spherical  coordinates. 

The  satellite  position  in  Cartesian  coordinates. 

The  interpolated  data  value  at  the  satellite  position. 
The  current  time  from  the  Satellite  position  (%)  slider. 


Pop  Label:  By  default,  if  a  marker  is  displayed,  it  will  be  positioned  based  on  the 

satellite’s  three-dimensional  location.  Other  objects  may  obscure  it.  If  the 
Pop  Label  toggle  is  on,  the  label  will  always  be  rendered  in  front  of  all 
other  objects  and  will  therefore  always  be  visible. 
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Label  Font: 


Reference  Frame: 


Thickness: 


The  Label  Font  selector  controls  the  font  size  used  for  the  annotation.  The 
options  include  the  machines  Default  font  (size  20)  and  Times  font  (sizes 
10,  20,  30,  40,  and  50). 

The  Reference  Frame  section  determines  how  the  SATELLITE  orbit 
should  be  rendered.  The  two  coordinate  options  are  geocentric  (GEOC) 
and  Earth  centered  inertial  (ECI). 

Geocentric:  Render  the  SATEEEITE  orbit  in  geocentric  (GEOC) 

coordinates.  Since  these  coordinates  are  rigidly  attached 
to  the  spinning  Earth  and  represent  a  non-inertial  frame, 
the  trajectory  will  not  be  approximately  elliptical  in 
shape. 

Inertial:  Render  the  SATEEEITE  orbit  in  Earth  centered  inertial 

(ECI)  coordinates.  Here  the  trajectory  will  have  an 
approximately  elliptical  shape.  Note  that  the  position  of 
the  orbit  rotates  when  animation  is  selected  because  the 
inertial  orbit  plane  is  not  fixed  in  geocentric 
coordinates. 

The  Thickness  slider  controls  the  width  of  the  plotted  orbit  line. 


223 

Approved  for  public  release;  Distribution  is  unlimited. 
AF-GEOSpace  User’s  Manual:  Version  2.5.1 


STARS 
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STARS  Overview 

The  STARS  graphical  object  renders  the  celestial  background  as  seen  from  the  Earth  for  a  given 
date  and  time.  Stars  as  dim  as  visual  magnitude  eight,  the  planets,  and  the  moon  can  be 
represented  with  this  module.  This  module  uses  the  Yale  Bright  Star  catalogue,  compiled  by  D. 
Hoffleit,  as  a  stellar  data  base.  Apparent  equatorial  coordinates  are  computed  for  the  equinox  of 
date  from  J2000  catalogued  positions;  these  are  corrected  for  stellar  proper  motion  as  well  as  the 
precession  and  nutation  of  the  Earth.  Eunar  and  planetary  positions  are  computed  from  the 
EORTRAN  codes  EEP82B  and  PLANET AP,  as  obtained  from  the  Astronomical  Data  Center  of 
Goddard  Space  Plight  Center.  Apparent  planetary  positions  in  the  Earth’s  frame  of  reference  are 
corrected  for  precession  and  nutation. 

In  a  ID  window,  the  STARS  graphical  object  does  nothing. 

In  a  2D  window,  STARS  does  nothing. 

In  a  3D  window,  the  STARS  graphical  object  plots  the  celestial  sphere  as  a  3 -dimensional 
background  to  the  near-Earth  space  environment.  An  option  exists  to  plot  this  background  as  a  3- 
dimensional  sphere  of  varying  radius. 

In  a  Heliospace  window,  STARS  does  nothing. 

In  a  Spectral  window,  STARS  does  nothing. 

The  STARS  graphical  object  supports  none  of  the  standard  options. 


STARS  Inputs 

The  STARS  graphical  module  requires  the  following  inputs: 


Detail: 


The  user  can  select  buttons  in  this  section  to  determine  which  objects  are 
drawn  in  the  celestial  sphere.  The  choices  are: 


Stars: 


Locate  and  draw  the  stars  as  white  squares. 


Stars:  color:  Plot  stars  in  color  instead  of  white.  Rendered  colors  are 

based  on  stellar  spectral  classification  type 
(OBAEGKM)  and  are  approximately  those  seen  by  the 
human  eye  from  the  Earth’s  surface. 

Stars:  circle:  Plot  stars  as  circles  instead  of  squares. 


Sun: 


Locate  and  draw  the  Sun. 
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Planets:  Locate  and  draw  the  eight  major  planets.  Planets  are 

color  coded  shaded  spheres,  and  are  approximately  the 
colors  seen  by  the  human  eye  through  a  small  telescope 
-  Mercury  and  Venus  are  white,  Mars  is  red,  Jupiter  is  a 
sandy  brown,  Saturn  is  yellowish,  Uranus  is 
aquamarine  while  Neptune  is  a  dark  turquoise. 

Moon:  Locate  and  draw  the  Earth’s  moon.  Plotted  as  a  white 

shaded  sphere  and  is  drawn  to  the  same  scale  as  the 
Earth  3D  object. 

Grid  Options:  Several  types  of  grids  may  be  placed  upon  the  surface  of  the  celestial 

sphere.  The  options  are: 

Eat/Eon  Grid:  Render  a  grid  showing  geographic  latitude  and 

longitude  upon  the  celestial  sphere  to  help  an  observer 
characterize  the  local  sky  at  a  given  location.  The 
resolution  is  ten  degrees. 

RA/DEC  Grid:  Render  a  grid  showing  Right  Ascension  and 

Decimation  of  the  background  celestial  sphere. 
Resolution  is  ten  degrees. 

Maximum  Magnitude:  This  slider  selects  the  visual  stellar  maximum  magnitude  (or  minimum 
brightness)  that  will  be  plotted  from  the  database  (magnitude  eight 
corresponds  to  minimum  brightness  setting).  A  total  of  91 10  stars  are 
catalogued  in  this  database.  Relative  brightness  is  modeled  within  the  code 
by  adjusting  the  pixel  size  and  RGB  color  intensity  of  a  plotted  star,  and 
corresponds  approximately  to  the  visual  magnitude  as  catalogued  in  the 
Yale  database. 

Maximum  Size  (pixels):  This  slider  controls  the  maximum  pixel  size  used  to  plot  the  brightest 

star,  i.e.,  Sirius.  Down  to  an  area  of  one  pixel,  the  brightness  of  the  star  is 
represented  by  the  size  of  the  star  in  pixels.  Below  one  pixel  size,  we 
reduce  the  intensity  of  the  individual  pixel.  Thus,  the  larger  the  value  of 
the  maximum  pixel  size,  the  dimmer  the  star  that  will  be  visible  in  the 
window. 

The  radius  of  the  celestial  sphere,  in  Earth  radii,  can  be  adjusted  with  this 
slider  when  the  Finite  Radius  option  is  activated  (see  below). 

Plot  stars  on  the  surface  of  a  sphere  with  a  radius  determined  by  the 
Celestial  Radius  slider. 

R=Inlinity:  Plot  stars  in  a  perspective  view  such  that  an  arbitrarily  large  celestial  sphere  is 

used  within  which  the  viewer  is  effectively  contained. 


Celestial  Radius: 
Einite  Radius: 
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STATION 


The  STATION  graphical  object  can  be  used  to  plot  a  labeled  location  on  or  above  the  surface  of 
the  Earth.  Rendering  of  the  STATION  graphical  object  is  dependent  on  the  window  type. 

In  a  ID  window,  the  STATION  graphical  object  does  nothing. 

In  a  2D  window,  the  STATION  graphical  object  plots  the  station  with  label  at  the  designated 
geographic  latitude  and  longitude. 

In  a  3D  window,  the  STATION  graphical  object  plots  the  station  with  label  at  the  designated 
geographic  latitude,  longitude,  and  altitude. 

In  a  Heliospace  window,  STATION  does  nothing. 

In  a  Spectral  window,  STATION  does  nothing. 

The  STATION  graphical  object  supports  the  Color  option. 

STATION  Inputs 

Stations:  The  Stations  list  presents  a  list  of  stations  currently  available  for  display  in 

2D  and  3D  windows.  To  display  a  station,  highlight  it  by  clicking  on  it  in 
the  Stations  list  and  click  the  Display  button.  To  create  a  new  station  and 
add  it  to  the  Stations  list,  fdl  in  the  Lat,  Lon,  Alt(Re),  and  Label  text  fields 
near  the  bottom  of  the  environment  options  and  click  the  Add  button.  To 
remove  a  station  from  the  Stations  list,  highlight  it  by  clicking  on  it  in  the 
Stations  list  and  click  the  Delete  button.  Changes  to  the  Stations  list  are 
saved  in  the  file  $AFGS_HOME\models\data\STATIONS\stations.dat 
which  can  also  be  edited  directly. 

Pop  Label:  The  Pop  Label  switch  forces  the  station  location  and  label  to  be  rendered 

in  front  of  all  other  objects. 

Label:  The  Label  type  selector  specifies  the  nature  of  the  text  written  at  the 

current  position  of  the  station.  The  available  labels  are: 

Off:  No  label  is  displayed. 

Label:  The  station  name  is  displayed. 

Rad,  Lat,  Lon:  The  station  position  is  displayed  in  geographic 

spherical  coordinates. 

X,  Y,  Z:  The  station  position  is  displayed  in  geographic 

Cartesian  coordinates. 

Label  Lont:  The  Label  Font  selector  controls  the  font  size  used  for  the  annotation.  The 

options  include  the  machines  Default  font  (size  20)  and  Times  font  (sizes 
10,  20,  30,  40,  and  50). 

Lat:  The  Lat  text  field  represents  the  station’s  North  geographic  latitude  in 

degrees. 
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Lon: 

Alt(Re): 

Label  (text  field): 
Add: 

Delete: 


The  Lon  text  field  represents  the  station’s  East  geographie  longitude  in 
degrees. 

The  Alt  (Re)  text  field  represents  the  station’s  altitude  in  Km  above  the 
Earth’s  surfaee. 

The  Label  text  field  represents  the  name  assigned  to  the  station  that  will 
appear  in  the  Stations  list. 

The  Add  button  allows  the  user  to  add  a  station  to  the  Stations  list.  The 
eharaeteristies  to  be  assoeiated  with  the  new  station  are  those  eurrently 
appearing  in  the  Lat,  Lon,  Alt(Re),  and  Label  text  boxes. 

The  Delete  button  allows  the  user  to  remove  a  station  from  the  Stations 
list.  To  remove  a  station,  highlight  its  name  in  the  Stations  list  and  eliek 
on  the  Delete  button. 
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VOLUME 


The  VOLUME  graphical  object  is  used  to  view  the  entire  volume  of  a  data  set  as  a  single  three- 
dimensional  object. 


The  VOLUME  graphical  object  rendering  is  dependent  on  the  window  type. 

In  a  ID  window,  the  VOLUME  graphical  object  does  nothing. 

In  a  2D  window,  the  VOLUME  graphical  object  does  nothing. 

In  a  3D  window,  the  VOLUME  graphical  object  renders  the  entire  data  set  as  a  single  three- 
dimensional  object. 

In  a  Heliospace  window,  VOLUME  does  nothing. 

In  a  Spectral  window,  VOLUME  does  nothing. 

The  VOLUME  graphical  object  supports  the  Clipping,  Transparency,  Color  Map,  aa&Data  Map 
options. 

Hint;  The  Transparency  option  and  the  Color  Map:  Alpha  option  are  very  useful  for  creating 
viewable  3-D  structures. 

VOLUME  Inputs 

Data:  The  Data  option  menu  is  used  to  select  the  data  set  to  be  used  by  the  VOLUME  graphics 
option.  This  option  must  be  set  to  a  data  set  before  rendering  is  allowed.  The  option  menu 
contains  a  list  of  valid  data  sets. 
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PARAMESH-COORDSLICE 


The  PARAMESH-COORD-SLICE  graphical  object  is  used  to  produce  a  slice  or  surface  through 
a  PARAMESH  data  set.  The  slice  is  produced  along  a  constant  of  one  coordinate  direction.  Eor 
example,  if  the  data  set  was  produced  using  a  Cartesian  grid,  the  PARAMESH-COORDSEICE 
graphical  object  produces  a  slice  at  constant  X,  Y,  or  Z  value.  Use  the  Open  Paramesh  option 
under  the  File  pulldown  menu  to  access  Paramesh  data  files. 

The  PARAMESH-COORD-SEICE  graphical  object  rendering  functions  only  within  the 
Heliospace  window. 

In  a  ID  window,  the  PARAMESH-COORDSLICE  graphical  object  does  nothing. 

In  a  2D  window,  the  PARAMESH-COORDSLICE  graphical  object  does  nothing. 

In  a  3D  window,  the  PARAMESH-COORDSLICE  graphical  object  does  nothing. 

In  a  HelioSpace  window,  the  PARAMESH-COORDSLICE  graphical  object  will  display  the 
coordinate  slice  through  the  data  set  in  three-dimensional  space. 

In  a  Spectral  window,  PARAMESH-COORDSLICE  does  nothing. 

The  PARAMESH-COORDSLICE  graphical  object  supports  the  Clipping,  Transparency,  Lights, 
Material,  Color,  Color  Map,  and  Data  Map  options,. 

PARAMESH-COORDSLICE  Inputs 

Data:  The  Data  option  menu  is  used  to  select  the  Paramesh  data  set  through 

which  the  PARAMESH-COORDSLICE  is  to  be  taken.  This  option  must 
be  set  to  a  data  set  before  rendering  is  allowed.  The  option  menu  contains 
a  list  of  valid,  previously  opened  NRLMHD  Paramesh  data  sets. 

Cut  Plane:  The  Cut  Plane  option  defines  the  constant  coordinate  from  the  choices  CO, 

Cl,  and  C2.  The  generic  names  represent  specific  coordinate  choices 
depending  upon  the  grid  type  of  the  data  set.  Eor  example,  if  the  grid  type 
of  the  data  set  is  spherical,  CO  will  produce  a  slice  at  constant  radius;  Cl 
will  produce  a  slice  at  constant  latitude;  C2  will  produce  a  slice  at  constant 
longitude.  Similarly,  if  the  data  set  has  a  Cartesian  grid,  the  CO,  Cl,  and 
C2  will  produce  slices  at  constant  X,  Y,  and  Z,  respectively. 

Display  Options:  The  Display  Options  field  will  allow  the  PARAMESH-COORDSLICE  to 

be  filled  as  colored  or  white  contours,  filled  or  discrete.  Any  combination 
of  the  options  may  be  selected. 

Eilled:  Render  the  PARAMESH-COORDSLICE  as  solid, 

filled,  color  contours. 

Grid:  An  outline  of  the  grid  will  be  shown  if  this  option  is 

turned  on. 

Values:  Data  values  will  be  displayed  at  grid  points. 

Contours:  Render  the  PARAMESH-COORDSLICE  as  discrete 

black  lines.  The  lines  represent  isovalues  of  the  data 
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Position  Value: 


Number  of  Contours: 


Veetor  Seale  Value: 


evenly  spaeed  between  the  data  minimum  and  the  data 
maximum.  The  number  of  eontours  is  determined  by 
the  Number  of  Contours  input. 

Contours:  Color  Similar  to  Contours,  but  the  isovalue  lines  are  eolored 
aeeording  to  the  eolor  bar  to  represent  the  magnitude  of 
the  isovalue. 


Veetors: 


Veetors:  Color 


Veetors:  Norm 


Render  white  segments  to  represent  the  direetion  of  the 
vector  field  of  the  selected  vector  type  data  at  the  Grid 
points  within  the  PARAMESH-COORDSLICE. 
Selection  of  the  parameter  magnitude  or  one  of  its 
components  all  result  in  the  complete  vector.  Vectors 
can  be  modified  using  the  Color  and  Norm  features. 

Vector  segments  are  colored  according  to  the  color  bar 
to  represent  its  magnitude. 

Vectors  are  all  plotted  using  equal  length  segments  to 
give  only  direction  information. 


The  Position  Value  option  determines  the  position  of  the  coordinate  slice. 
The  position  value  represents  the  position  (normalized  to  range  from  0  to 
1)  along  the  constant  coordinate.  Eor  example,  if  the  dataset  has  a 
spherical  grid  and  the  CO  coordinate  is  chosen,  PARAMESH- 
COORDSLICE  will  produce  a  slice  at  constant  radius.  The  position  value 
input  will  select  the  value  of  the  radius  at  which  to  produce  the  slice. 


The  Number  of  Contours  input  slider  determines  the  number  of  contour 
lines  to  be  plotted  between  the  data  minimum  and  the  data  maximum  if  the 
Display  Options  selection  is  Contours  or  Contours:  Color. 


The  Vector  Scale  Value  input  slider  is  used  to  amplify  the  length  of  all 
vectors  plotted  by  a  constant  scaling  factor. 
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PARAMESH-FIELDLINES 


The  PARAMESH-FIELDLINES  graphical  object  is  used  to  produce  fieldlines  generated  by 
tracing  a  vector  field  through  a  PARAMESH  data  set.  Use  the  Open  Paramesh  option  under  the 
File  pulldown  menu  to  access  Paramesh  data  files. 

The  PARAMESH-  FIELDLINES  graphical  object  rendering  functions  only  within  the 
Heliospace  window. 

In  a  ID  window,  the  PARAMESH-FIELDLINES  graphical  object  does  nothing. 

In  a  2D  window,  the  PARAMESH-FIELDLINES  graphical  object  does  nothing. 

In  a  3D  window,  the  PARAMESH-FIELDLINES  graphical  object  does  nothing. 

In  a  HelioSpace  window,  the  PARAMESH-FIELDLINES  graphical  object  will  display  field 
lines  of  vector  quantities  such  as  magnetic  field  and  momentum  density  through  the  data  set  in 
three-dimensional  space. 

In  a  Spectral  window,  PARAMESH-FIELDLINES  does  nothing. 

The  PARAMESH-FIELDLINES  graphical  object  supports  the  Clipping,  Lights,  Material,  Color, 
Color  Map,  and  Data  Map  options. 

PARAMESH-FIELDLINES  Inputs 

Data:  The  Data  option  menu  is  used  to  select  the  Paramesh  data  set  through 

which  the  PARAMESH-FIELDLINES  are  traced.  This  option  must  be  set 
to  a  data  set  before  rendering  is  allowed.  The  option  menu  contains  a  list 
of  valid,  previously  opened  NRLMHD  Paramesh  data  sets. 

Two  methods  for  defining  the  starting  points  of  field-lines  are  provided.  Start  Plane  and  User 
Defined,  and  their  selectors  are  located  immediately  under  the  Data  button.  Field-lines  derived 
using  both  methods  can  be  viewed  simultaneously  using  a  single  PARAMESH-FIELDLINES 
graphical  object. 

Start  Plane:  The  Start  Plane  method  allows  the  generation  of  field-line  sets  originating 

from  evenly  distributed  points  in  pre-defined  planes.  Field-lines  starting 
from  the  following  Start  Planes  can  be  displayed  simultaneously: 

X  Min,  Y  Min,  Z  Min:  Designate  planes  coincident  with  the  minimum 
values  of  the  X,  Y,  or  Z  coordinates. 

X  Mid,  Y  Mid,  Z  Mid:  Designate  planes  coincident  with  the  mid-point 
values  of  the  X,  Y,  or  Z  coordinates. 

X  Max,  Y  Max,  Z  Max:  Designate  planes  coincident  with  the  maximum 
values  of  the  X,  Y,  or  Z  coordinates. 

Number  of  Starting  Points:  The  number  of  field-lines  traced  from  each 

Start  Plane  is  the  same  and  are  evenly  distributed  along 
the  remaining  two  dimensions.  Each  dimension  is 
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divided  in  the  designated  number  of  cells  and  one  field¬ 
line  from  the  center  of  each  one  is  traced. 

X  and  Y :  Number  of  starting  points  evenly 

distributed  along  the  X  and  Y  directions, 
respectively.  For  an  X  plane,  the  number 
of  starting  points  in  the  Z  direction  is 
represented  by  the  X  entry.  Similarly,  for 
a  Y  plane,  the  number  of  starting  points  in 
the  Z  direction  is  represented  by  the  Y 
entry. 

User  Defined;  With  the  User  Defined  method,  field-lines  with  arbitrary  starting  point 

locations  can  be  added  or  deleted  to  the  Current  Field  Line  list  by  using 
the  Add  and  Delete  buttons,  respectively.  The  settings  for  each  field-line 
are  displayed  when  its  entry  is  visible  in  the  Current  Field  Line  list. 

Current  Field  Line:  The  starting  point  location  for  the  field-line  entry 
visible  in  the  Current  Field  Line  list  is  controlled  by 
position  sliders  and  coordinate  position  values  appear  in 
text  boxes  under  each  slider. 

X  Position:  Translate  the  field-line  start  point  along 
the  X  axis  (red  axis  of  grid  domain) 

Y  Position:  Translate  the  field-line  start  point  along 
the  Y  axis  (green  axis  of  grid  domain) 

Z  Position:  Translate  the  field-line  start  point  along 
the  Z  axis  (blue  axis  of  grid  domain) 

Update:  This  button  refreshes  the  field-line 

The  following  common  options  appear  at  the  bottom  of  the  Environment  Window. 

Direction:  Three  options  are  provided  designating  the  direction  of  field-line  tracing 

Forward;  Trace  the  field-line  in  the  direction  of  the  vector  field. 

Back:  Trace  the  field-line  in  the  direction  opposite  the  field. 

Forward  +  Back:  Trace  the  field-line  in  both  the  Forward  and  Back 
directions 

Render  Direction:  The  Render  Direction  option  modifies  the  color  intensity  along  the  length 

of  the  field  lines  in  a  repeating  pattern  that  indicates  the  direction  of  the 
vector.  The  bright  end  of  each  segment  is  oriented  to  designate  the  head 
of  the  vector.  During  use  of  Animation,  these  features  will  appear  to  move 
along  the  field  line.  To  function,  the  field  lines  must  be  rendered  as  Lines 
or  Cylinders  (see  below). 

Off:  The  option  is  inactive. 
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Render  As: 


Show  Color: 

Smooth: 
Line  Width: 


Type  1,  2,  3:  Seleeting  one  of  the  Type  indieators  aetives  the 

Rendering  Direction  option.  The  three  types  differ  in 
the  length  along  the  field  line  eontaining  the  bright-to- 
dim  eoloring  pattern 

Three  options  are  provided  for  modifying  the  appearanee  of  field-lines 

Lines:  Represent  field-lines  as  simple  lines. 

Lit  Lines:  Represent  field-lines  as  simple  lighted  lines. 

Cylinders:  Represent  field-lines  as  3-D  eylinders  with  shadows. 

Field-lines  are  eolored  aeeording  to  the  eolor  bar  to  represent  the 
magnitude  of  the  field. 

Smooths  the  rendering  of  the  field-lines. 

Adjust  the  apparent  width  of  the  field-lines 
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PARAMESH-FIELDLINES-II 


The  PARAMESH-FIELDLINES-II  graphical  object  is  used  to  produce  fieldlines  generated  by 
tracing  a  vector  field  through  a  PARAMESH  data  set.  Use  the  Open  Paramesh  option  under  the 
File  pulldown  menu  to  access  Paramesh  data  files. 

The  PARAMESH-  FIELDLINES-II  graphical  object  rendering  functions  only  within  the 
Heliospace  window. 

In  a  ID  window,  the  PARAMESH-FIELDLINES-II  graphical  object  does  nothing. 

In  a  2D  window,  the  PARAMESH-FIELDLINES-II  graphical  object  does  nothing. 

In  a  3D  window,  the  PARAMESH-FIELDLINES-II  graphical  object  does  nothing. 

In  a  HelioSpace  window,  the  PARAMESH-FIELDLINES-II  graphical  object  will  display  field 
lines  of  vector  quantities  such  as  magnetic  field  and  momentum  density  through  the  data  set  in 
three-dimensional  space 

In  a  Spectral  window,  PARAMESH-FIELDLINES-II  does  nothing. 

The  PARAMESH-FIELDLINES-II  graphical  object  supports  the  Clipping,  Lights,  Material, 
Color,  Color  Map,  and  Data  Map  options. 


PARAMESH-FIELDLINES  Inputs 

Data:  The  Data  option  menu  is  used  to  select  the  Paramesh  data  set  through 

which  the  PARAMESH-FIELDLINES-II  is  traced.  This  option  must  be 
set  to  a  data  set  before  rendering  is  allowed.  The  option  menu  contains  a 
list  of  valid,  previously  opened  NRLMHD  Paramesh  data  sets. 

Two  methods  for  defining  the  starting  points  of  field-lines  are  provided.  Start  Plane  and  User 
Defined,  and  their  selectors  are  located  immediately  under  the  Data  button.  Field-lines  derived 
using  both  methods  can  be  viewed  simultaneously  using  a  single  PARAMESH-FIELDLINES-II 
graphical  object. 


Direction: 


Render  As: 


Smooth: 
Show  Color: 


Three  options  are  provided  designating  the  direction  of  field-line  tracing 

Both:  Trace  the  field-line  in  both  the  Forward  and  Back 

directions. 

Forward:  Trace  the  field-line  in  the  direction  of  the  vector  field. 

Back:  Trace  the  field-line  in  the  direction  opposite  the  field. 

Three  options  are  provided  for  modifying  the  appearance  of  field-lines 
Lines:  Represent  field-lines  as  simple  lines. 

Lit  Lines:  Represent  field-lines  as  simple  lighted  lines. 

Cylinders:  Represent  field-lines  as  3-D  cylinders  with  shadows. 

Smooths  the  rendering  of  the  field-lines. 

Field-lines  are  colored  according  to  the  color  bar  to  represent  the 
magnitude  of  the  field. 


234 

Approved  for  public  release;  Distribution  is  unlimited. 
AF-GEOSpace  User’s  Manual:  Version  2.5.1 


Line  Width;  Adjust  the  apparent  width  of  the  field-lines. 

Current  Group:  An  organized  eolleetion  or  grouping  of  fieldlines  can  be  displayed  with 

this  graphics  module.  The  Current  Group  pulldown  list  shows  the  name 
given  to  the  set  of  fieldline  traces  currently  viewable  with  the  module.  If 
NONE  is  visible,  then  no  fieldline  groups  are  currently  available  for 
viewing.  The  following  two  options  can  be  used  to  create/delete  groups. 

Create:  The  Create  button  generates  a  Para-Mesh  Field  Line 

Create  popup  window  used  to  generate  a  new  entry  for 
the  Current  Group  list.  For  each  new  group  of  fieldline 
starting  points,  the  following  options  are  available. 

Name:  The  Name  text  box  is  used  to  create  the  name  to 
appear  in  the  Current  Group  list. 

Type;  The  user  can  select  to  generate  either  a  single 
Point  or  a  collection  of  points  arranged  in  a  Line, 

Circle,  Plane,  or  Sphere. 

Start  Position:  The  starting  location  for  the  next  group 
of  points  can  set  as  either  the  Last  Position  used  by  the 
previous  group  or  as  the  Origin. 

Axis:  The  axis  of  orientation  for  the  newly  created 
group  will  be  the  X,  Y,  or  Z  axis. 

X  Res  (and/or)  Y  Res:  The  number  of  trace  starting 
points  along  the  X  and  Y  coordinate  directions  is 
assigned  using  these  text  fields. 

Delete:  The  Delete  button  will  remove  the  group  currently 

visible  in  the  Current  Group  list. 

Transform:  The  following  transformation  options  enable  the  user  to  translate,  rotate, 

and  scale  the  Current  Group  of  fieldline  starting  points. 

Translate;  Selecting  the  Translate  option  activates  three  sliders 

{Translate  X,  Translate  Y,  and  Translate  Z)  that  enable 
the  user  to  move  the  Current  Group  of  fieldlines  along 
the  X,  Y,  and  Z  coordinates. 

Rotate:  Selecting  the  Rotate  option  activates  three  sliders  {Rotate 

X,  Rotate  Y,  and  Rotate  Z)  that  enable  the  user  to  rotate 
the  Current  Group  of  fieldlines  about  the  X,  Y,  and  Z 
coordinates. 

Scale:  Selecting  the  Scale  option  activates  the  top  slider  which 

can  then  be  used  to  spread  or  shrink  the  cluster  of 
fieldline  tracing  start  points. 
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PARAMESH-GRID 


The  PARAMESH-GRID  graphical  object  is  used  to  display  the  grid,  block  structure  (e.g.,  leaf 
and  parent  block),  and  overall  domain  of  a  PARAMESH  data  set.  Grid  features  can  be  color 
coded  to  reflect  processor  used  and  block  level.  Use  the  Open  Paramesh  option  under  the  File 
pull-down  menu  to  access  Paramesh  data  files. 

The  PARAMESH-GRID  graphical  object  rendering  functions  only  within  the  Heliospace 
window. 

In  a  ID  window,  the  PARAMESH-GRID  graphical  object  does  nothing. 

In  a  2D  window,  the  PARAMESH-GRID  graphical  object  does  nothing. 

In  a  3D  window,  the  PARAMESH-GRID  graphical  object  does  nothing. 

In  a  HelioSpace  window,  the  PARAMESH-GRID  graphical  object  will  display  the  Paramesh 
grid. 

In  a  Spectral  window,  PARAMESH-GRID  does  nothing. 

The  PARAMESH-GRID  graphical  object  supports  the  Lights  and  Color  options. 

PARAMESH-GRID  Inputs 

Data:  The  Data  option  menu  is  used  to  select  the  Paramesh  data  set  to  be  used 

by  the  PARAMESH-GRID  graphics  option.  This  option  must  be  set  to  a 
data  set  before  rendering  is  allowed.  The  option  menu  contains  a  list  of 
valid,  previously  opened  NRLMHD  Paramesh  data  sets. 

Render  Styles:  The  Render  Styles  field  allows  the  PARAMESH-GRID  to  be  displayed  as 

discrete  points,  representing  the  grid  cell  vertices,  or  the  lines  connecting 
those  grid  cell  vertices. 

Point:  Display  grid  cell  vertices  as  discrete  points 

Outline:  Display  the  lines  connecting  grid  cell  vertices 

Color  Method:  The  Color  Method  field  allows  the  PARAMESH-  GRID  to  be  colored 

using  a  single  user-selected  color,  or  according  to  processor  number,  or 
grid  level. 

Solid:  Render  the  grid  using  a  single  solid  color.  The  Color 

graphics  option  can  be  used  to  set  Grid  color  when  this 
method  is  selected. 

Processor  Number:  Set  grid  colors  according  to  the  assigned  processor 

number,  i.e.,  all  grid  points  of  a  common  color  share  a 
processor. 

Eevel:  Set  grid  colors  according  to  the  assigned  level  number, 

i.e.,  all  grid  points  of  a  common  color  represent  grid 
points  at  the  same  level. 

Render  Blocks:  Render  a  selection  of  PARAMESH-  GRID  blocks. 
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Leaf: 

Leaf  +  Parent: 

Max  Depth: 

Root  Blocks: 
All: 

Domain: 

Domain  Hull: 


Display  only  Leaf  grid  cells.  Leaf  cells  are  those  used 
to  divide  Parent  grid  cells  into  smaller  divisions. 

Display  both  Leaf  +  Parent  grid  cells.  Parent  grid  cells 
represent  the  initial  divisions  of  the  computation  grid. 

Display  only  the  smallest  size  grid  cells  representing 
the  maximum  depth  within  the  grid. 

Display  only  grid  cells  representing  Root  Blocks. 

Display  Root,  Parent,  and  Leaf  grid  cell  blocks 

Display  the  overall  domain  of  the  grid  with  filled  side 
panels  and  colored  arrows  representing  the  grid 
coordinate  directions,  i.e.,  for  Cartesian  coordinates  the 
X,  y,  and  z  directions  are  show  using  red,  green,  and 
blue  arrows,  respectively.  The  Color  graphics  option 
can  be  used  to  set  the  color  of  the  Domain  and  Domain 
Lines  color. 

Display  grid  domain  cube  only  with  colored  axes  (no 
filled  side  panels). 
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PARAMESH-ISOCONTOUR 


The  PARAMESH-ISOCONTOUR  graphical  object  is  used  to  produce  a  surface  of  constant 
value  through  a  three-dimensional  PARAMESH  data  set.  Use  the  Open  Paramesh  option  under 
the  File  pulldown  menu  to  access  Paramesh  data  files. 

The  PARAMESH-ISOCONTOUR  graphical  object  rendering  functions  only  within  the 
HelioSpace  window. 

In  a  ID  window,  the  PARAMESH-ISOCONTOUR  graphical  object  does  nothing. 

In  a  2D  window,  the  PARAMESH-ISOCONTOUR  graphical  object  does  nothing. 

In  a  3D  window,  the  PARAMESH-ISOCONTOUR  graphical  object  does  nothing. 

In  a  HelioSpace  window,  the  PARAMESH-ISOCONTOUR  graphical  object  will  display  the 
constant  value  surface  through  the  data  set  in  three-dimensional  space. 

In  a  Spectral  window,  PARAMESH-ISOCONTOUR  does  nothing. 

The  PARAMESH-ISOCONTOUR  graphical  object  supports  the  Clipping,  Transparency, 
Material,  Lighting,  Material,  Color  Map,  and  Data  Map  options. 

PARAMESH-ISOCONTOUR  Inputs 

Data:  The  Data  option  menu  is  used  to  select  the  main  data  set  through  which 

the  PARAMESH-ISOCONTOUR  is  to  be  taken.  This  option  must  be  set 
to  a  data  set  before  rendering  is  allowed.  The  option  menu  contains  a  list 
of  valid,  previously  opened  NRLMHD  Paramesh  data  sets. 

Contour  Value:  The  Contour  Value  slider  input  determines  the  value  of  the  constant 

surface.  The  values  will  range  from  the  minimum  to  the  maximum  for  the 
chosen  data  set.  The  number  below  the  slider  (0-to-l)  corresponds  to  the 
range  (minimum-to-maximum)  of  the  data  values  shown  on  the  color  bar. 

PARAMESH- VOLUME 

The  PARAMESH- VOLUME  graphical  object  is  used  to  view  the  entire  volume  of  a 
PARAMESH  data  set  as  a  single  three-dimensional  object.  Use  the  Open  Paramesh  option 
under  the  File  pulldown  menu  to  access  Paramesh  data  files. 


The  PARAMESH- VOLUME  graphical  object  rendering  functions  only  within  the  HelioSpace 
window. 

In  a  ID  window,  the  PARAMESH- VOLUME  graphical  object  does  nothing. 

In  a  2D  window,  the  PARAMESH- VOLUME  graphical  object  does  nothing. 

In  a  3D  window,  the  PARAMESH- VOLUME  graphical  object  does  nothing. 

In  a  HelioSpace  window,  the  PARAMESH-VOLUME  graphical  object  will  display  the  entire 
volume  of  a  data  set  in  three-dimensional  space. 

In  a  Spectral  window,  PARAMESH-VOLUME  does  nothing. 
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The  PARAMESH- VOLUME  graphical  object  supports  the  Clipping,  Transparency,  Lights, 

Material,  Color  Map,  and  Data  Map  options. 

Hint;  The  Transparency  option  and  the  Color  Map:  Alpha  option  are  very  useful  for  creating 

viewable  3-D  structures. 

PARAMESH-VOLUME  Inputs 

Data:  The  Data  option  menu  is  used  to  select  the  Paramesh  data  set  to  be  used 

by  the  PARAMESH-VOLUME  graphics  option.  This  option  must  be  set 
to  a  data  set  before  rendering  is  allowed.  The  option  menu  contains  a  list 
of  valid,  previously  opened  NRLMHD  Paramesh  data  sets. 

Use  Lighting;  The  Use  Lighting  option  activates  directional  lighting  on  the  rendered  volume. 
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GRAPHICAL  MODULE  OPTIONS 

This  section  describes  the  visualization  controls  and  options  available  when  running  graphics 
modules.  The  options  appear  as  buttons  on  the  right  side  of  each  Graphics  Module  window  and 
set  of  controls  for  each  will  appear  at  the  bottom  of  the  Environment  Window  as  options  are 
selected.  Options  unavailable  for  a  particular  graphics  module  are  grayed  out.  The  effects  of 
selecting  and  editing  an  option  apply  only  to  the  graphics  module  currently  highlighted  in  the 
Active  Modules  list.  To  alter  the  appearance  of  another  graphics  object,  select  its  entry  in  the 
Active  Modules  list  so  that  it  is  highlighted. 

The  following  options  are  currently  supported  in  AF-GEOSpace, 

•  DISPLAY:  The  Display  option  is  used  to  display  a  graphics  object  in  an  active  viewport. 
This  option  appears  in  all  graphics  modules. 

•  INTERACTIVE:  The  Interactive  option  controls  whether  graphical  renderings  are  updated 
as  changes  are  made  to  the  graphic  inputs.  This  option  appears  in  all  graphic  modules. 

•  USE  TEXTURE;  The  Use  Texture  mapping  option  improves  the  appearance  of  color  data 
contours.  This  option  appears  in  all  graphics  modules. 

•  LIGHTING:  The  Lighting  option  enables  the  Lights  and  Material  options  to  be  active. 

•  CLIPPING:  The  Clipping  option  applies  clipping  planes  to  a  graphical  object. 

•  TRANSPARENCY:  The  Transparency  option  controls  the  degree  of  transparency  of  a 
graphical  object. 

•  LIGHTS:  The  Lights  option  controls  lighting  effects  on  a  graphical  object. 

•  MATERIAL:  The  Material  option  controls  the  light  reflection  properties  of  a  graphical 
object. 

•  COLOR:  The  Color  option  controls  the  color  of  a  graphical  object. 

•  COLOR  MAP:  The  Color  Map  option  controls  the  color  map  representing  a  data  set  in  the 
window  color  bar. 

•  DATA  MAP:  The  Data  Map  option  controls  the  range  and  linear/log  scale  used  to  display 
data. 
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The  DISPLAY  Graphical  Option 

The  Display  option  determines  whether  the  graphieal  object  is  displayed  in  the  active  plot 
window.  It  provides  a  convenient  method  for  temporarily  stopping  the  display  of  the  object. 

The  INTERACTIVE  Graphical  Option 

The  Interactive  option  is  used  to  force  the  appearance  of  displayed  graphical  object  to  update 
automatically  as  changes  are  made  to  the  graphical  settings.  If  Interactive  is  not  selected,  then 
some  selection  changes  made  in  the  graphics  module  window  will  not  appear  on  screen  until  the 
Display  button  is  toggled  off/on. 

The  USE  TEXTURE  Graphical  Option 

The  Use  Texture  option  is  used  to  improve  the  rendering  of  graphical  objects  by  applying  texture 
mapping  smoothing  algorithms  to  the  data  set  before  displaying.  The  use  of  this  option  provides 
the  most  accurate  display  of  data  sets  so  it  is  recommended  that  this  option  remain  active. 

The  LIGHTING  Graphical  Option 

The  Lighting  option  enables  the  Lights  and  Material  options  to  be  active.  If  Lighting  is  not 
selected,  then  uniform  light  is  applied  on  all  objects. 


The  CLIPPING  Graphical  Option 

The  CLIPPING  graphical  option  is  used  to  produce  the  effect  of  clipping  planes  on  a  graphical 
object.  The  user  can  activate  and  define  up  to  6  clipping  planes  at  a  time.  To  activate  and  define 
an  individual  clipping  plane:  Select  a  plane  (i.e..  Plane  0,  Plane  1,  Plane  2,  Plane  3,  Plane  4,  or 
Plane  5),  activate  it  using  the  Enabled  toggle  switch,  and  adjust  the  rotation  and  translation 
sliders.  The  slider  settings  apply  only  to  the  Plane  currently  selected.  The  settings  for  individual 
planes  are  saved  for  the  duration  of  a  session.  Additional  clipping  planes  are  created  the  same 
way  and  can  be  toggled  On/Off  to  tailor  3D  displays. 


Clipping  Parameters 

Plane  0-5:  Select  one  of  6  independent  clipping  planes. 


Rotate  X: 


Rotate  Y : 


Rotate  Z: 


The  Rotate  X  input  slider  rotates  the  position  of  the  clipping  plane  around 
the  horizontal  direction  in  the  plane  of  the  user’s  computer  screen. 

The  Rotate  Y  input  slider  rotates  the  position  of  the  clipping  plane  around 
the  vertical  direction  in  the  plane  of  the  user’s  computer  screen. 

The  Rotate  Z  input  slider  rotates  the  position  of  the  clipping  around  the 
direction  normal  to  the  plane  of  the  user’s  computer  screen. 


Translate:  The  Translate  input  slider  translates  the  position  of  the  clipping  plane 

along  the  direction  perpendicular  to  the  current  position  of  the  plane,  as  set 
by  the  rotation  sliders. 


Enabled: 


Toggle  for  activating  the  selected  clipping  plane,  i.e..  Plane  0. 
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The  TRANSPARENCY  Graphical  Option 

The  TRANSPARENCY  graphical  option  is  used  to  produce  the  effect  of  transparency  on  a 

graphical  object. 

Transparency  Parameter 

Transparency:  The  Transparency  slider  controls  the  fraction  of  light,  “Alpha”, 

transmitted  through  the  object.  A  value  of  1.0  corresponds  to  complete 
opacity  and  a  value  of  0.0  corresponds  to  complete  transmission,  i.e.,  the 
object  is  invisible. 


The  LIGHTS  Graphical  Option 

The  LIGHTS  option  is  used  to  model  the  effect  of  light  on  a  graphical  object.  The  user  can 
activate  and  define  up  to  4  independent  lighting  sources  plus  activate  2  solar  oriented  lighting 
sources  at  a  time.  To  activate  and  define  an  individual  lighting  source:  Select  a  source  (i.e..  Light 
0,  Light  1,  Light  2,  or  Light  3),  activate  it  using  the  Enabled  toggle  switch,  and  adjust  the 
properties  of  the  source,  e.g..  Position.  The  slider  settings  apply  only  to  the  light  source  currently 
selected.  The  settings  for  individual  sources  are  saved  for  the  duration  of  a  session.  Additional 
light  sources  are  created  the  same  way  and  can  be  toggled  using  the  Enable  switch  to  tailor  3D 
displays. 


Lighting  Parameters 

Ambient: 

Specular: 

Diffuse: 

Position: 

Red/Lat: 

Green/Long: 

Blue: 

Light  0-3: 

Sun: 

Opp  Sun: 

Enabled: 


Set  the  ambient  intensity  of  the  light. 

Set  the  specular  intensity  of  the  light. 

Set  the  diffuse  intensity  of  the  light. 

Set  the  position  of  the  selected  light  source. 

Specify  the  fraction  of  red  or  the  latitude  when  position  is  selected. 
Specify  the  fraction  of  green  or  the  longitude  when  position  is  selected. 
Specify  the  fraction  of  blue. 

Select  one  of  4  independent  lighting  sources. 

Select  a  light  source  coming  from  the  solar  direction. 

Select  a  light  source  coming  from  the  anti-solar  direction. 

Toggle  the  lighting  characteristics. 
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The  MATERIAL  Graphical  Option 

The  MATERIAL  option  is  used  to  modify  the  light  reflection  properties  of  graphical  objects. 


Material  Parameters 

Emission: 

Diffuse: 

Specular: 

Shininess: 


Set  the  emissiveness  of  material. 

Set  the  diffuseness  of  the  material. 

Set  the  specular  property  of  the  material. 
Set  the  shininess  of  the  material. 


The  COLOR  Graphical  Option 

The  COLOR  option  is  used  to  modify  the  color  of  graphical  objects.  Selecting  the  Color  option 
while  viewing  a  graphical  module  displays  color  selection  inputs  for  the  RGB  and  HSV  color 
systems  along  with  a  list  of  graphical  object  components  to  which  they  may  be  applied.  Colors 
can  also  be  selected  directly  from  the  color  wheel  by  placing  the  cursor  in  the  color  wheel  and 
clicking  the  left  mouse  button.  The  current  color  selection  appears  in  the  solid  colored  rectangle 
below  the  color  wheel.  All  color  selections  made  will  apply  to  the  component  of  the  graphical 
object  current  selected  from  the  list  appearing  to  the  left  of  the  sliders  and  the  color  wheel.  Color 
changes  remain  in  affect  for  the  remainder  of  the  session. 

Color  Parameters 

RGB:  Selecting  the  RGB  option  displays  a  set  of  Red-Green-Blue  sliders  for 

blending  color. 

HSV:  Selecting  the  HSV  option  displays  a  set  of  Hue-Saturation-Value  sliders 

for  blending  color. 
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The  COLOR  MAP  Graphical  Option 

The  COLOR  MAP  option  is  used  to  modify  the  mapping  of  eolors  assigned  to  data  values  shown 
in  the  eolor  bar.  This  option  is  aeeessed  using  the  Color  Map  button  on  the  right  side  of  the 
Graphies  Module  option  windows. 

Color  Mapping  Parameters 

Color/data  mapping  characteristics  are  adjusted  by  manipulating  plotted  functions  that  appear  in 
the  Color  Map  Editor  window  representing  each  characteristic,  e.g.,  the  RGB  or  HSV  color 
options.  The  representative  functions  consist  of  anchor  blocks  connected  by  lines  that  can  be 
moved  by  clicking  on  anchor  blocks  and  dragging  them  to  new  positions  using  the  mouse.  The 
Color  Map  options  are: 

Line:  The  Line  option  is  used  to  connect  all  adjacent  anchor  blocks  by  line 

segments. 

Curve:  The  Curve  option  is  used  to  change  the  lines  connecting  all  anchor  blocks 

into  a  single  simple  curve. 

RGB:  Selecting  the  RGB  option  displays  a  set  of  Red-Green-Blue- Alpha  options 

for  blending  color.  Selecting  a  RGB  option  will  result  in  its  color  map  line 
appearing  in  the  Color  Map  Editor  window.  The  anchor  blocks  of  each 
line  can  be  moved  vertically  by  clicking  and  dragging  on  it  using  the 
mouse.  As  an  anchor  block  is  moved,  the  color  bars  at  the  bottom  of  the 
Environment  Window  and  in  the  graphics  window  will  change.  Interior 
anchor  blocks  can  be  added/removed  using  the  Insert! Delete  buttons 
described  below.  The  RGB  options  are: 


Red: 

Specify  the  fraction  of  red. 

Green: 

Specify  the  fraction  of  green. 

Blue: 

Specify  the  fraction  of  blue. 

Alpha: 

Specify  the  fraction  of  light  transmitted. 

HSV:  Selecting  the  HSV  option  displays  a  set  of  Hue-Saturation-Value -Alpha 

options  for  blending  color.  Selecting  an  HSV  option  will  result  in  its  color 
map  line  appearing  in  the  Color  Map  Editor  window.  The  anchor  blocks 
of  each  line  can  be  moved  vertically  by  clicking  and  dragging  on  it  using 
the  mouse.  As  an  anchor  block  is  moved,  the  color  bars  at  the  bottom  of 
the  Environment  Window  and  in  the  graphics  window  will  change. 
Interior  anchor  blocks  can  be  added/removed  using  the  Insert! Delete 
buttons  described  below.  The  HSV  options  are: 

Hue:  Specify  the  color  hues. 

Sat:  Specify  the  saturation  of  the  colors. 

Value:  Specify  the  value  of  the  color  intensities. 

Alpha:  Specify  the  fraction  of  light  transmitted. 
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Addition  flexibility  in  prescribing  color  mapping  is  gained  by  inserting/removing  interior  anchor 
blocks.  Interior  anchor  blocks  can  be  moved  horizontally  and  vertically  with  the  mouse  by 
clicking  and  dragging  them.  The  tools  for  editing  the  anchor  blocks  are: 

Insert:  The  Insert  button  is  used  to  add  an  interior  anchor  block.  To  add  a  block, 

first  use  the  mouse  to  click  on  the  anchor  block  marking  the  left  border  of 
the  segment  to  contain  the  new  anchor  block,  then  click  on  the  Insert 
button  and  the  new  moveable  anchor  block  will  appear. 

Delete:  The  Delete  button  is  used  to  remove  an  interior  anchor  block.  The  end 

anchor  blocks  cannot  be  removed.  To  remove  a  block,  use  the  mouse  to 
click  on  the  block,  then  use  the  Delete  button  and  chosen  anchor  block 
will  disappear. 


The  DATA  MAP  Graphical  Option 

The  DATA  MAP  option  is  used  to  modify  the  range  and  linear/log  scaling  of  the  data  displayed. 
The  range  of  the  data  displayed  must  fall  within  the  range  of  the  data  set  being  displayed. 


Data  Mapping  Parameters 


Data  Min: 


Data  Max: 


Auto: 


Log  10: 


The  Data  Min  text  window  controls  the  minimum  data  value  to  be 
displayed.  To  update  the  displayed  plotting  scale  after  editing  this  text 
box,  place  the  cursor  in  the  Data  Max  text  box  or  use  the  Update  button. 
Selecting  values  less  than  the  actual  minimum  of  the  data  set  is  not 
permitted. 

The  Data  Max  text  window  controls  the  maximum  data  value  to  be 
displayed.  To  update  the  displayed  plotting  scale  after  editing  this  text 
box,  place  the  cursor  in  the  Data  Min  text  box  or  use  the  Update  button. 
Selecting  values  greater  than  the  actual  maximum  of  the  data  set  is  not 
permitted. 

The  Auto  option  resets  the  displayed  data  minimum  and  maximum  values 
to  those  of  the  original  data  set. 

The  Log  10  option  changes  the  displayed  data  scale  from  linear  to  Log 
scale  base  10  and  vice  versa.  For  x  <  0,  the  value  of  LoglO(x)  will  be  set 
equal  to  -6. 
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DATA  MODULES 


Data  modules  provide  methods  for  reading  and  plotting  data  sets  produeed  and  formatted 
external  to  AF-GEOSpace.  The  data  modules  are  accessed  through  the  data  module  manager  that 
becomes  visible  when  the  Data  option  in  the  Module  pulldown  menu  is  activated.  The  data 
module  manager  consists  of  two  lists  -  Available  Modules  and  Active  Modules.  Available 
Modules  are  the  modules  that  are  currently  supported  by  AF-GEOSpace.  Active  Modules  are 
modules  that  have  been  created  and  used  by  the  AF-GEOSpace  user  during  the  current  session. 

When  initially  accessed,  the  data  module  manager  will  show  a  list  of  data  modules  under 
Available  Modules.  Since  no  data  modules  have  yet  been  created,  the  Active  Modules  list  will  be 
empty. 

Currently,  the  following  data  modules  are  supported  by  AF-GEOSpace: 

•  DMSP:  The  DMSP  data  module  enables  the  display  (via  the  DMSP  graphics  module)  of 
electron  and  ion  energy  spectra  and  integrated  precipitating  flux  measured  by  the  DMSP 
SSJ4/5  particle  sensors. 

•  EPHEMERIS:  The  EPHEMERIS  Data  Module  allows  user-generated  time-ordered  data  and 
satellite  ephemeris  to  be  loaded  into  AF-GEOSpace.  After  loading  a  file,  data  and  satellite 
trajectory  can  be  displayed  using  the  Orbit  Probe  (ID)  and  Satellite  (3D)  graphical  modules, 
respectively.  This  module  facilitates  data/model  comparisons  as  the  user-provided  satellite 
trajectory  can  be  used  to  sample  other  AF-GEOSpace  environment  models. 

•  GRID:  The  GRID  Data  Module  allows  user-generated  files  of  gridded  data  in  either 
spherical  or  Cartesian  coordinates  to  be  loaded  into  AF-GEOSpace.  After  loading  a  file,  data 
can  be  displayed  using  all  AF-GEOSpace  graphical  modules. 
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Running  Data  Modules 

To  run  a  data  module,  use  the  mouse  to  seleet  the  Data  option  in  the  Module  pulldown  menu  and 
Available  Modules  ?Lnd  Active  Modules  lists  will  appear  in  the  Environment  Window.  Cliek  on 
the  desired  ehoiee  under  Available  Modules.  For  example,  to  ereate  a  new  version  of 
EPHEMERIS,  eliek  the  mouse  on  EPHEMERIS  in  the  Available  Modules  list.  Choosing  a  data 
module  will  do  two  things:  first,  the  ehoiee  is  added  to  the  Active  Modules  list;  seeond,  the 
options  assoeiated  with  the  ehosen  data  module  will  appear  in  the  Environment  Window.  In 
general,  eaeh  data  module  will  have  a  different  Environment  Window  representing  the  module 
speeifie  inputs.  Adjust/seleet  the  module  inputs  as  required. 

The  Delete  option  in  the  Edit  pulldown  menu  is  used  to  remove  the  highlighted  data  module 
member  of  the  Active  Modules  list.  Note  that  all  aetive  graphies  objeets  must  be  removed  before 
the  seienee  module  used  to  generate  their  data  ean  be  removed. 
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The  DMSP  Data  Module 


Model  Name:  DMSP 

Version:  2010 


Developer:  Boston  College  and  the  Air  Foree  Researeh  Laboratory 

Referenees:  Brautigam,  D.H.,  M.S.  Gussenhoven,  and  D.A.  Hardy,  A  Statistieal  Study 

on  the  Effects  of  IMF  Bz  and  Solar  Wind  Speed  on  Auroral  Ion  and 
Electron  Precipitation,  J.  Geophys.  Res,  96,  5525-5538  (1991) 


DMSP  Overview 

The  DMSP  Data  Module  enables  the  display  of  electron  and  ion  energy  spectra  measured  by  the 
DMSP  SSJ/4  (SSJ/5  for  DMSP  F16  and  higher)  and  SSEES  sensors  as  a  function  of  time.  The 
spectra  are  determined  in  the  local  satellite  zenith  direction  once  per  second  over  20  energy 
channels  spanning  the  range  30  eV  to  30  keV  [e.g.,  Brautigam  et  al.  (1991)].  The  current  version 
allows  the  user  to  view  a  list  of  daily  data  files  for  DMSP  spacecraft  F6  through  F20  (El  8  was 
the  last  spacecraft  launched  before  this  software  release)  and  process  an  orbit  from  one  file  set 
for  viewing  with  the  DMSP  Graphical  Module.  The  five  daily  data  files  processed  by  this 
module  for  each  spacecraft  have  names  which  include  date  and  spacecraft  identifiers  in  the 
following  formats: 

Four  files  with  naming  formats  ^NNCCYYMMMDDA^ii  {NN  is  the  DMSP  spacecraft  number,  CC 
is  the  two-character  string  “dm”,  “mp”,  “rp”,  or  “sm”,  YY  is  the  two-digit  year,  MMMis  the  3- 
letter  month  abbreviation,  and  DD  is  the  day  of  month)  and  one  file  with  name  format 
i4iNNYYDOY  (where  DOY  is  the  3-digit  day  of  year)  are  required.  For  example,  for  the  DMSP 
El  3  spacecraft  on  4  April  2003  (day  of  year  94)  the  user  would  require  access  to  the  following 
five  files:  fl3dm03apr04.dat,  fl3mp03apr04.dat,  fl3rp03apr04.dat,  fl3sm03apr04.dat,  and 
j4fl 303095.  As  described  in  the  following  note,  some  sample  DMSP  data  fdes  are  provided  to 
allow  users  to  exercise  the  DMSP  Data  and  Graphical  Modules  (see  “DMSP  Precipitating 
Particles:  Data  Versus  Climatology”  in  the  EXAMPEES  section  of  this  manual).  DMSP  data 
files  may  be  obtained  from  NOAA  NGDC  (http://www.ngdc.noaa.gov/dmsp/availability.html). 

Note:  If  the  DMSP  data  files  to  be  accessed  are  always  stored  in  a  fixed  location  then 
they  can  be  automatically  located  by  the  DMSP  Data  Module  if  a  startup 
environment  variable  is  set.  At  the  time  of  installation,  the  startup  file 
SAFGS _HOME\bin\AFGeospace.bat  contains  the  following  line: 

set  PLGS_DMSP_DATADIR=$AFGS_HOME\models\data\DMSP\2003 

where  SAFGS  HOME  represents  the  AF-GEOSpace  install  directory.  A  few  days 
of  data  for  DMSP  spacecraft  El  3  are  stored  within  this  directory.  A  2010 
directory  is  also  included  containing  a  weeks  worth  of  El  7  and  El  8  data.  It  is 
recommended  that  DMSP  data  be  stored  in  the  designated  directory  in  individual 
yearly  directories,  e.g.,  in  directories  named  2003,  2004,  etc.  If  data  are  to  be 
routinely  stored  in  a  different  fixed  location,  then  the  AFGeospace.bat  file  should 
be  updated  appropriately. 
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DMSP  Inputs 

The  user  ean  seleet  the  DMSP  data  souree  and  individual  quantities  of  interest  by  using  the 

following  DMSP  Options: 

Global  Parameters:  Year  (Day,  UT,  Kp,  SSN,  and  Ap  are  not  used).  If  DMSP  data  are  stored 
in  direetories  named  by  years,  as  suggested  in  the  above  note,  then  the 
Year  input  helps  loeate  appropriate  files.  Note  that  the  entered  year  value 
is  also  used  to  eonstruet  some  plotting  labels  by  the  DMSP  Graphieal 
Module  so  the  proper  year  should  be  entered  to  avoid  eonfusion. 

Satellite:  The  Satellite  seleetion  feature  provides  aeeess  to  daily  DMSP  data  files  for 

individual  spaeeeraft  F06  through  F20  or  for  All  available  spaeecraft  data. 
If  any  data  is  loeated  for  the  selected  satellite(s),  a  list  of  J4  data  files  (with 
names  formatted  as  }4iNNYYDOY)  will  appear  in  the  sliding  list  below. 
Although  they  do  not  appear  in  the  list,  the  other  required  DMSP  data  files 
associated  with  the  J4  fide  selected  will  be  processed  when  the  Run/Update 
option  of  the  Edit  menu  is  used.  If  data  files  are  not  stored  in  the  location 
designated  in  the  AFGeospace.bat  fide  (see  note  above),  then  use  the 
Browse  button  described  below. 


Orbit  Number  (1-15):  Because  the  DMSP  orbit  is  approximately  90  minutes,  the  Orbit  Number 
selector  offers  daily  orbit  options  numbered  1-15. 

J5  Mode  B  (1-6):  [Note:  This  option  is  currently  inactive].  The  J5  sensor  carried  on 

spacecraft  starting  with  DMSP  F16  include  particle  data  from  6  different 
pitch  angle  bins  this  J5  Mode  B  option  prepares  a  selected  bin  for  viewing. 
The  values  1-6  correspond  to  six  15°  directional  zones  (0°  to  90°  relative  to 
local  vertical). 


Data  Values: 


The  six  data  options  available  for  each  DMSP  daily  files  are  as  follows: 

Integral  Energy  Flux:  Prepare  electron  and  proton  integral  energy  flux  for 
plotting  in  units  of  keV/(cm  -s-sr)  by  selecting  this 
option. 


Integral  Number  Flux:  Prepare  electron  and  proton  integral  number  flux 
for  plotting  in  units  of  log[#/(cm  -s-sr)]  by  selecting 
this  option. 

Average  Energy:  Prepare  electron  and  proton  average  energy  for  plotting 
in  units  of  keV  by  selecting  this  option. 

Drift  Velocity:  Prepare  horizontal  and  vertical  drift  velocities  for 

plotting  in  units  of  m/s  by  selecting  this  option.  Note 
that  not  all  data  file  sets  contain  drift  velocity  data. 


B  Vector:  Prepare  magnetic  field  components  Bx,  By,  and  Bz  for 

plotting  in  units  of  nT  by  selecting  this  option.  Note 
that  not  all  data  file  sets  contain  magnetic  field  data. 
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Background;  Remove  sensor  eontamination,  i.e.,  false  partiele  eounts 
resulting  from  the  presenee  of  energetie  radiation  belt 
partiele,  by  seleeting  this  option. 

Browse:  The  Browse  button  is  used  to  loeate  the  direetory  eontaining  the  DMSP 

data  file  sets  (Five  files  per  satellite  per  day).  Seleeting  the  Browse  button 
brings  up  an  Open  popup  window.  Locate  the  direetory  eontaining  the  data 
files,  highlight  one  of  J4  or  J5  files,  and  hit  the  Open  button  to  plaee  the 
file  names  in  the  environment  window. 

After  all  DMSP  input  selections  are  made,  use  the  Run/Update  option  of  the  Edit  menu  to 
prepare  the  seleeted  DMSP  orbit  data  for  viewing. 

DMSP  Outputs 

The  Run/Update  option  of  the  Edit  menu  is  used  to  prepare  the  seleeted  DMSP  output  quantities 
(i.e.,  integrated  energy  flux,  integral  number  flux,  average  energy,  drift  veloeity,  and  magnetie 
field  along  the  seleeted  DMSP  orbit)  for  viewing  using  the  DMSP  Graphieal  Module  in 
eonjunetion  with  1-D  and  Speetral  Viewports.  Onee  the  data  has  been  displayed  using  the 
Graphieal  Module,  the  user  may  return  to  this  module,  adjust  the  options,  and  use  the 
Run/Update  option  again  to  refresh  the  existing  graphies.  Note  that  the  corresponding  DMSP 
satellite  orbit  traek  is  not  eurrently  automatically  generated  but  see  “DMSP  Precipitating 
Particles:  Data  Versus  Climatology”  in  the  EXAMPLES  seetion  of  this  manual  for  instruetions 
on  generating  the  orbit  using  the  SATEE-APP  module  and  the  appropriate  orbital  element  files. 
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The  EPHEMERIS  Data  Module 

Model  Name:  EPHEMERIS 

Version:  2012 

Developer:  AER,  Inc.,  Boston  College,  and  the  Air  Eorce  Research  Eaboratory 

EPHEMERIS  Overview 

The  EPHEMERIS  Data  Module  allows  user-generated  time-ordered  data  and  satellite  ephemeris 
to  be  loaded  into  AE-GEOSpace.  After  loading  the  data  and  satellite  trajectory  can  be  displayed 
using  the  Orbit  Probe  (ID)  and  Satellite  (3D)  graphical  modules,  respectively.  This  module  is 
convenient  for  comparing  observed  satellite  data  with  models  as  the  user-provided  satellite  can 
be  “flown”  through  other  AE-GEOSpace  environments. 

EPHEMERIS  Input 

The  EPHEMERIS  input  consists  of  a  user-created  ASCII  data  file  containing  a  single  header  line 
and  an  arbitrary  number  of  data  lines  describing  a  satellite  position  and  data  values  associated 
with  that  position.  The  file  format  is  described  in  the  next  section.  To  load  a  data  file  into  AE- 
GEOSpace  use  the  Open  File  button  and  the  Open  window  appears.  After  selecting  an  ephemeris 
file,  the  Open  button  loads  the  data,  closes  the  popup  window,  and  places  the  chosen  file’s  name 
in  the  Environment  Window  just  above  the  Open  File  button.  The  file  contents  should  then  be 
ready  for  display  using  the  Orbit  Probe  and  Satellite  graphics  modules.  Note  that  the 

EPHEMERIS  Data  File  Format 

The  EPHEMERIS  Data  module  accepts  data  files  containing  a  single  header  line  followed  by  an 
arbitrary  number  of  data  lines.  The  format  is  as  follows: 

Year  Day  Coordtype  Ncolumns  Caption-1  Caption-2  Caption-3 
Time  Coord-1  Coord-2  Coord-3  Column-1  Column-2  Column-3 
Time  Coord-1  Coord-2  Coord-3  Column-1  Column-2  Column-3 

Time  Coord-1  Coord-2  Coord-3  Column-1  Column-2  Column-3 

The  file  $AFGS_HOME\models\data\EPHEMERlS\ephemeris_sample2001 _161.dat  is  provided 
for  the  user  to  exercise  this  module.  In  the  sample  file,  the  Year  and  Day  in  the  first  line  are  equal 
to  2001  and  161,  respectively.  Note:  Eor  files  formatted  for  the  EPHEMERIS  module  released  in 
AE-GEOSpace  V2.0  to  work,  the  Year  value  must  be  added  to  the  beginning  of  the  first  line. 

The  elements  of  the  header  line  are  defined: 

Year:  Year  (Integer) 

Day  :  Day  of  year  (Integer).  Note  that  the  Calendar  Worksheet  can  be  used  to 

determine  day  of  a  given  Year/Month/Day  of  Month. 

Coordtype:  Integer  specifying  the  coordinate  system  used  to  represent  the  satellite 

location.  The  options  are: 

Coordtype  =  0  for  Cartesian  GEOC  system  X,  Y,  Z  measured  in  km) 
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Coordtype  =  1  for  Spherical  GEOC  system  expressed  in  geocentric  Radius 
(km),  Latitude(degrees),  and  East  Eongitude  (degrees) 


Geocentric  GEOC  coordinate  system:  The  Z  axis  is  aligned  with  the  north 
rotational  pole,  the  X  axis  pierces  the  Greenwich  Meridian  on  the  equator 
(0  deg  Long,  0  deg  Eat),  and  the  Y  axis  completes  the  right  handed 
system. 

Ncolumns:  Integer  number  of  columns  of  data  to  be  read  (limit  0-3)  after  the  time 

and  position. 

Caption-1,  -2,  -3:  Text  captions  for  data  columns  (number  of  captions  must  match 

Ncolumns) 

The  elements  the  arbitrary  number  of  data  line  are: 


Time: 

Coord-1,  -2,  -3: 


Column-1,  -2,  -3: 


Elapsed  time  in  seconds  from  the  start  of  the  Day  given  in  the  header  line. 

Coordinate  values  depend  on  the  coordinate  type  specified  in  the  header 
line  by  Coordtype. 

If  Coordtype  =  0,  then  {Coord-1,  Coord-2,  Coord-3)  =  (X,  Y,  Z  )  of  the 
Cartesian  GEOC  system  (km,  km,  km). 

If  Coordtype  =  I,  then  {Coord- 1,  Coord-2,  Coord-3)  =  (Radius,  Latitude, 
East  Longitude)  of  the  spherical  GEOC  system  (km,  degrees,  degrees). 

Data  values  (floats)  for  columns  (number  of  data  values  must  match 
Ncolumns) 


Viewing  EPHEMERIS  Data  and  Satellite  Orbit 

The  data  loaded  can  be  viewed  in  a  ID  window  using  the  Orbit  Probe  graphics  module.  After 
EPHEMERIS  has  been  run,  the  Path/Abscissa  and  Data/Ordinate  buttons  in  the  Orbit  Probe 
Environment  Window  will  contain  an  option  labeled  AppReadOrbit  representing  the  ephemeris 
data  from  this  module. 

The  orbit  represented  by  the  Coord-1,  -2,  -3  values  can  be  displayed  in  a  3D  window  using  the 
Satellite  graphic  module  by  selecting  the  satellite  named  EPHEMERIS.  The  orbit  can  also  be 
colored  to  correspond  to  the  loaded  data  by  selecting  a  data  option  using  the  Data  button. 

To  animate  ID  or  3D  plots  containing  Ephemeris  data,  the  Global  time  interval  (or  the  time 
interval  in  the  Animate  window)  must  encompass  the  Year,  Day  and  Times  in  the  Ephemeris  file. 
Eor  this  reason,  it  is  convenient  to  include  the  day  number  in  the  ephemeris  data  file  name.  Note 
that  if  the  satellite  locations  are  entered  using  Cartesian  X,  Y,  Z  {Coordtype  =  0),  they  are 
automatically  translated  into  Spherical  coordinates  (with  radius  in  Re)  for  output  displays. 
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The  GRID  Data  Module 


Model  Name:  GRID  Data 

Version:  August  2009 

Developer:  AER,  Inc.  and  the  Air  Force  Research  Laboratory 

GRID  Overview 

The  GRID  Data  Module  allows  a  user-generated  file  of  3-D  gridded  data  in  either  spherical  or 
Cartesian  coordinates  to  be  loaded  into  AF-GEOSpace.  After  loading  a  file,  data  can  be 
displayed  using  all  AF-GEOSpace  graphical  models.  This  module  is  convenient  for  comparing 
gridded  output  from  external  models  with  each  other  and  with  the  model  environments  of  AF- 
GEOSpace  and  extracting  model  results  along  portions  of  satellite  orbits. 

GRID  Input 

The  GRID  input  consists  of  a  user-created  ASCII  data  file  formatted  as  described  in  the  next 
section.  The  file  $AFGS_HOME\models\data\GRIDDATA\griddata_sample.dat  is  provided  for 
the  user  to  exercise  this  module.  To  load  a  data  file  into  AF-GEOSpace  use  the  Select  File 
button  and  an  Open  popup  window  appears.  After  selecting  a  GRID  Data  file,  the  Open  button 
loads  the  data,  closes  the  popup  window,  and  places  the  chosen  file’s  name  in  the  Environment 
Window  just  above  the  Select  File  button.  When  a  properly  formatted  data  fide  is  selected,  the 
header  information  in  the  file  is  displayed  so  the  user  can  Select  data  values  to  read  by 
highlighting,  i.e.,  clicking  on,  each  desired  data  parameter  to  be  loaded,  and  then  selecting 
Run/Update  from  the  Edit  menu.  The  gridded  data  will  then  be  loaded  into  memory  and  ready 
for  display.  Note  that  not  selecting  at  least  one  parameter  from  the  list  will  result  in  a  generic 
popup  error  message.  Other  error  messages  are  displayed  when  necessary,  but  note  that  some  of 
these  are  currently  only  shown  in  one  of  the  text  shell  windows.  Note  that  the  Grid  Tool  option 
in  the  Edit  menu  can  be  used  before  selecting  Run/Update  to  specify  internal  spherical  display 
grid  characteristics.  After  using  Run/Update,  the  Data  Tool  option  in  the  Edit  menu  can  be  used 
to  examine  actual  grid  point  locations  and  the  parameter  values  loaded  for  display. 

GRID  Data  File  Format 

The  GRID  Data  module  accepts  data  files  containing  a  single  header  line  followed  by  an 
arbitrary  number  of  data  lines.  The  contents  of  the  file  header  are  verified  to  contain  the 
necessary  keywords,  parameters  and  information;  error  messages  are  displayed  if  the 
requirements  are  not  met.  Data  values  of  magnitude  3.0x10  and  greater  are  considered  invalid 
values,  and  are  so  honored  in  the  graphical  displays.  The  grid  locations  may  be  specified  in 
terms  of  radius,  latitude,  and  longitude  values,  and/or  GEOC  geocentric  Cartesian  X,  Y,  Z 
coordinates.  Some  alternative  coordinate  options  are  described  in  the  data  file  header  description 
below.  A  maximum  of  32  data  values  may  be  loaded  simultaneously.  The  data  values  are 
mapped  to  a  regularly-spaced  geocentric  grid.  When  multiple  data  values  are  assigned  to  the 
same  grid  point,  the  maximum  value  is  used. 

There  is  no  limit  to  the  number  of  data  points  contained  in  a  file  but  larger  numbers  will,  of 
course,  require  more  read  time  and  computer  memory  resources. 
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The  file  ean  contain  any  number  of  leading  comment  lines,  each  starting  with  a  ‘#’  character. 
The  Grid  Data  module  only  examines  these  comment  lines  following  a  line  with  ‘#  griddata’. 
An  example  header  is  shown  below,  and  a  line-by-line  description  and  explanation  follows: 

#  example  Grid  Data  file  header 

#  ONERA  IGRF  magnetic  field  2004/001  00:00  UT 

#  ~~  any  number  of  leading  comment  lines,  starting  with  a  '#' 

# 

a)  #  GRIDDATA 

b)  #  SPEC  6371.2  31371.2  500.0  10.0  10.0 

c)  #  LABELS  index  rad  colat  Ion  geox  geoy  geoz  Bx  By  Bz  Angle  Bmag 

d)  #  UNITS  index  km  deg  deg  km  km  km  unit  unit  unit  deg  nT 

e)  #  EXCL  OIIIIIIIIIOI 

1  6371.2  10. 0  0.0  1106.3473  0.0000  6274.4072  -0.29053679 

-0.01779209  -0.95669839  -73.07731  5 . 43049825Ie+04 

2  6371.2  10. 0  10. 0  1089.5394  192. 1152  6274.4072  -0.28753001 

-0.05I220I9  -0.95640106  -73.01888  5 . 44I620738e+04 

3  6371.2  10. 0  20.0  1039.6264  378.3931  6274.4072  -0.277I7I32 

-0.08372591  -0.95716563  -73.16953  5 . 464I38I82e+04 

4  6371.2  10. 0  30.0  958.1248  553.1736  6274.4072  -0.25962456 

-0.II439485  -0.95891027  -73.51827  5 . 497I7I473e+04 


Required  line  ‘a’,  starting  with  “#  griddata”,  is  the  first  line  that  will  be  recognized  by  the  Grid 
Data  module.  This  line  must  be  before  any  other  of  the  other  specification  lines.  The  other 
specification  lines  may  be  in  any  order,  as  long  as  they  appear  before  the  first  line  of  data. 

Optional  line  ‘b’,  starting  with  “#  spec  ”,  describes  the  spherical  grid  used  in  the  display  of  the 
data  in  the  file.  The  values,  in  this  specific  order,  are  as  follows:  radius  (Re  or  km)  or  altitude 
(km)  minimum,  maximum,  and  increment,  latitude  increment  (deg),  and  longitude  increment 
(deg).  When  this  line  is  omitted,  the  spherical  grid  ranges  and  increments  will  be  automatically 
ascertained  from  the  data  file  contents.  In  general,  at  least  three  comer  grid  points  need  to  be 
populated  to  get  a  color  block/triangle,  thus  if  input  points  are  too  sparse  for  the  grid  then  data 
limits  will  be  detected  but  no  graphics  can  be  generated.  The  grid  configuration  may  also  be 
modified  via  the  Grid  Tool  option  of  the  Edit  menu  prior.  Note  that  defining  a  grid  which  is 
much  finer  than  that  of  the  data  provided  can  result  in,  for  example,  stripped  coordinate  slices. 

Required  line  ‘c’,  starting  with  “#  labels”,  lists  the  space-separated  data  name  labels  for  each  of 
the  file’s  data  columns.  Specific  data  name  labels  are  used  for  indicating  which  of  the  grid 
coordinate  columns  are  available  in  the  file.  Not  all  need  be  present. 

•  ‘geox’,  ‘geoy’  and  ‘geoz’  correspond  to  the  GEOC  Cartesian  XYZ  coordinates  (in  km). 

•  ‘rad’  or  ‘radius’  correspond  to  radius  (in  km,  or  Rg  if  value  <50) 

•  ‘alt’  or  ‘altitude’  correspond  to  altitude  (in  km) 

•  ‘lat’  or  ‘latitude’  correspond  to  latitude  (-90  to  +90  deg) 

•  ‘colat’  or  ‘colatitude’  correspond  to  colatitudes  (0  to  180  deg) 

•  ‘ion’  or  ‘longitude’  Correspond  to  longitude  (-180  to  +360  deg) 

Any  labels  not  fully  matching  these  specific  keywords  will  be  interpreted  as  data  parameters. 
These  data  parameter  labels  will  be  shown  in  the  Grid  Data  module  user  interface,  the  graphical 
display  data  list,  and  be  shown  at  the  top  of  the  color  scale  legend  of  the  graphical  display. 
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Required  line  ‘d’,  starting  with  “#  units”,  lists  the  corresponding  space-separated  unit  labels 
associated  with  the  data  name  labels  on  line  ‘c’.  These  labels  will  be  shown  at  the  bottom  of  the 
color  scale  legend  of  the  graphical  displays. 

Optional  line  ‘e’,  starting  with  “#  excl”,  enables  certain  columns  of  data  to  be  excluded  from 
being  recognized  as  data  parameters  for  display.  This  is  useful  for  excluding  columns  containing 
character  strings,  date/time  strings,  or  values  with  no  meaning  to  the  other  data  (i.e.  line  counter). 
Values  of ‘i’  indicate  data  parameters  to  be  included,  and  ‘o’  to  be  excluded.  The  number  of 
values  specified  on  this  line  must  match  those  for  the  labels  and  units.  This  example  shows  that 
the  first  column,  ‘index’,  and  the  11*  column,  ‘Angle’,  will  be  ignored. 

All  remaining  lines  of  the  file  contain  the  grid  coordinate  and  data  values,  as  specified  in  the 
header  lines. 

Note  that  missing/misspelled  required  key  words  (griddata,  labels ,  units),  too  few/many 
entries  in  required  lines,  or  excluding  one  of  three  coordinate  values  will  result  in  no  parameter 
choices  appearing  in  the  data  values  box  and  the  appearance  of  an  “error  running  model”  popup. 

Data  values  in  the  file  are  assumed  to  be  space-separated  integer  or  floating  point  values  on  each 
line,  corresponding  to  the  specified  column  labels.  Data  values  greater  or  equal  to  3.0x10  are 
considered  to  be  the  special  ‘No  Data’  value,  and  will  not  be  shown  in  the  graphical  display. 

Any  instances  of ‘NaN’  or  ‘inf’  should  be  replaced  with  a  ‘No  Data’  value.  All  character  strings 
used  to  specify  labels  and  units  must  be  free  of  any  internal  spaces  so  they  will  be  read  as 
single  entries  associated  with  a  given  column. 

As  the  file  is  processed,  the  coordinate  values  are  first  read  from  the  line,  and  converted  to 
radius,  latitude  and  longitude  if  required.  If  these  coordinates  do  not  match  up  to  the  spherical 
grid  points  as  defined  in  line  ‘b’  (or  the  defaults),  the  nearest  grid  point  is  used.  The  selected 
data  values  are  read  from  the  rest  of  the  line  and  are  loaded  into  memory  associated  to  the 
spherical  grid  point.  In  the  case  where  more  than  one  set  of  data  values  is  associated  to  the  same 
spherical  grid  point,  the  maximum  data  values  are  retained.  Any  spherical  grid  points  without 
any  data  are  filled  with  the  special  ‘No  Data’  value. 

While  there  is  no  limit  to  the  number  of  positions  in  the  spherical  grid  definition,  nor  a  limit  on 
the  number  of  grid  positions  specified  in  the  file,  an  excessive  number  of  points  will  cause  long 
file  processing  times  and  the  memory  required  could  potentially  surpass  the  amount  available  on 
the  host  computer. 

GRID  Data  Outputs 

The  GRID  Data  module  returns  a  static  3D  Gridded  Data  Set  of  the  quantities  listed  in  the 
LABELS  line  of  the  user-generated  data  file. 
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WORKSHEET  MODULES 


Worksheet  modules  provide  auxiliary  tools  that  are  often  helpful  in  AF-GEOSpaee  ealculations. 
The  worksheet  modules  are  aceessed  through  the  worksheet  module  manager  that  beeomes 
visible  when  the  Worksheet  option  in  the  Module  pulldown  menu  is  aetivated.  The  worksheet 
module  manager  consists  of  two  lists  -  Available  Modules  and  Active  Modules.  Available 
Modules  are  the  modules  that  are  currently  supported  by  AF-GEOSpace.  Active  Modules  are 
modules  that  have  been  created  and  used  by  the  AF-GEOSpace  user  during  the  current  session. 

When  initially  accessed,  the  worksheet  module  manager  will  show  a  list  of  worksheet  modules 
under  Available  Modules.  Since  no  worksheet  modules  have  yet  been  created,  the  Active 
Modules  list  will  be  empty. 

Currently,  the  following  worksheet  modules  are  supported  by  AF-GEOSpace; 

•  CALENDAR:  A  calendar  showing  month  and  day,  day  of  year,  and  modified  Julian  day. 

•  COORD_TRANSFORM:  Perform  coordinate  transformations  on  point  locations  using 
different  coordinate  systems  (GEOC,  GSM,  SM,  GEI)  and  coordinate  geometries  (Cartesian, 
Cylindrical,  Spherical)  at  a  given  Year,  Day,  and  UT. 
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Running  Worksheet  Modules 

To  run  a  worksheet  module,  use  the  mouse  to  select  the  Worksheet  option  in  the  Module 
pulldown  menu  and  Available  Modules  and  Active  Modules  lists  will  appear  in  the  Environment 
Window.  Click  on  the  desired  choice  under  Available  Modules.  For  example,  to  create  a  new 
version  of  CALENDAR,  click  the  mouse  on  Calendar  in  the  Available  Modules  list.  Choosing  a 
worksheet  module  will  do  two  things:  first,  the  choice  is  added  to  the  Active  Modules  list; 
second,  the  options  associated  with  the  chosen  worksheet  module  will  appear  in  the  Environment 
Window.  In  general,  each  worksheet  module  will  have  a  different  Environment  Window 
representing  the  module  specific  inputs.  The  outputs  of  worksheet  modules  are  displayed  in  the 
same  interactive  Environment  Window  with  the  inputs.  The  user  edits  text  boxes  and  sets 
selectors  in  the  Environment  Window  and  then  places  the  cursor  in  some  other  text  box  to  run 
the  module  and  update  the  displayed  result. 

The  Delete  option  in  the  Edit  pulldown  menu  is  used  to  remove  the  highlighted  worksheet 
module  member  of  the  Active  Modules  list. 
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The  CALENDAR  Worksheet  Module 


Model  Name: 
Version: 
Developer: 
Referenees: 


Calendar 

1996 

Rodger  Biasea,  Boston  College 
NONE 


CALENDAR  Overview 

The  CALENDAR  Worksheets  module  displays  a  ealendar  showing  a  speeified  month.  If  the 

Year  (Month)  text  box  is  edited  directly,  the  calendar  updates  when  the  cursor  is  placed  inside 

the  Month  (Year)  text  box  or  by  exiting  and  re-entering  the  Calendar  worksheet. 

CALENDAR  Inputs 

The  CALENDAR  worksheet  module  requires  the  following  inputs: 

Year:  The  year  of  the  calendar  to  display.  Year  values  can  be  changed  by  editing 

the  Year  text  box  or  by  advancing  the  month  using  the  up/down  arrow 
buttons  next  to  the  Month  text  box. 

Month:  The  month  of  the  calendar  to  display.  Month  values  can  be  changed  by 

editing  the  text  box  or  by  using  the  arrow  buttons. 

CALENDAR  Outputs 

CALENDAR  displays  the  specified  month  of  the  specified  year.  The  dates  include  day  of  year 

(DOY)  and  modified  Julian  day  (MJD  =  0  on  1  Jan  1950). 
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The  COORD-TRANSFORM  Worksheet  Module 


Model  Name:  COORD-TRANSFORM 

Version:  2006  (ineludes  IGRF  2005  updates  for  magnetie  eoordinates) 

Developer:  Boston  College  and  Air  Foree  Researeh  Laboratory 

Referenees:  Bhavnani,  K.H.,  and  R.P.  Vaneour,  Coordinate  Systems  for  Spaee  and 

Geophysieal  Applieations,  PL-TR-91-2296,  Phillips  Laboratory,  Hanscom 
AFB,  MA  (1991),  ADA  247550 

Russell,  C.T.,  Geophysieal  Coordinate  Systems,  Cosmic  Electrodynamics, 
2,  184-196  (1971) 

COORD-TRANSFORM  Overview 

The  COORD  TRANSFORM  worksheet  module  allows  the  user  to  perform  a  eoordinate 

transform  of  a  single  point. 

COORD-TRANSFORM  Inputs 

The  COORD-TRANSFORM  worksheet  module  requires  the  following  inputs: 

Year/Day/UT:  The  year,  day  of  year,  and  UT  at  whieh  to  perform  the  eoordinate 

eonversion. 

Inputs:  The  geometry  and  eoordinate  system  options  for  the  input  point  are: 

Geometry:  The  Geometry  options  for  the  input  point  are: 

Cartesian:  Generate  a  grid  in  Cartesian  geometry. 

Cylindrieal:  Generate  a  grid  in  eylindrieal 

geometry. 

Spherieal:  Generate  a  grid  in  spherieal  geometry. 

Coord  System:  The  Coord  System  options  for  eoordinate  system  of  the 

input  point  are: 

GEOC:  Geoeentrie  eoordinate  system:  The  Z 

axis  is  aligned  with  the  north  rotational 
pole,  the  X  axis  pierees  the  Greenwieh 
Meridian  on  the  equator  (0  deg  Long,  0 
deg  Lat),  and  the  Y  axis  eompletes  the 
right  handed  system. 

GSM:  Geoeentrie  solar  magnetospherie 

eoordinate  system:  The  X  axis  points  to 
the  Sun.  The  Z  axis  is  perpendieular  to  X 
and  lies  in  the  plane  eontaining  the 
magnetie  dipole  axis.  The  Y  axis 
eompletes  the  right  handed  system  and  is 
positive  towards  dusk. 
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SM;  Solar  magnetic  coordinate  system:  The 

X  axis  is  perpendicular  to  Z  and  lies  in 
the  plane  containing  the  Z  axis  and  the 
Earth-Sun  line.  The  Z  axis  is  coincident 
with  the  magnetic  dipole  axis.  The  Y 
axis  completes  the  right  handed  system 
and  is  positive  towards  dusk. 

GET  Geocentric  equatorial  inertial  coordinate 

system:  The  Z  axis  is  the  same  as  for  the 
geocentric  coordinate  system  {GEOC). 
The  X  axis  points  in  the  direction  of  the 
first  point  of  Aries  (vernal  equinox).  The 
Y  axis  completes  the  right  handed 
system.  The  angle  between  the  X  axis 
and  Greenwich  Meridian  is  set  by  the 
UT  from  the  animation  widget. 

CO,  Cl,  C2  :  The  three  coordinate  components  of  the  input  point  are 

entered  by  editing  text  boxes  with  names  that  change 
according  to  the  Ceometry/Coord  System  combination 
selected. 

Outputs:  The  geometry  and  coordinate  system  options  for  the  output  point  are  the 

same  as  for  the  input  point. 

COORD-TRANSFORM  Outputs 

COORD-TRANSEORM  displays  the  three  components  of  the  output  point  in  the  new  units  at  the 
bottom  of  the  Environment  Window.  These  values  are  updated  every  time  a  Geometry  or  Coord 
System  selection  is  changed  or  whenever  a  Year,  Day,  UT,  CO,  Cl,  or  C2  text  box  is  edited  and 
the  cursor  is  then  placed  in  another  text  boxes. 
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EXAMPLES 


This  section  provides  a  set  of  detailed  examples  demonstrating  some  of  the  modeling  and  display 
capabilities  of  AF-GEOSpace.  Each  one  starts  with  a  brief  statement  describing  the  goal  of  the 
example.  It  is  the  authors’  belief  that  the  most  efficient  way  to  learn  the  program  is  by  working 
through  an  example  or  two. 

Example  titles  containing  the  comment  “(Dynamic)”  make  use  of  the  AE-GEOSpace  dynamic 
run  capability,  i.e.,  the  environment  will  be  calculated  for  a  series  of  time  steps  using  a  history  of 
global  input  parameters.  Examples  without  this  designation  are  “Static”,  i.e.,  environments  are 
calculated  at  a  single  time  using  one  set  of  global  parameters. 

Example  titles  containing  the  comment  “(V2.5.1  Only)”  require  Science  or  Application  modules 
provided  only  in  AE-GEOSpace  Version  2.5.1  distributed  to  pre-approved  government 
institutions  and  their  agents.  See  Release  Notes  on  the  User’s  Manual  and  Software  at  the 
beginning  of  this  document. 
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1)  Space  Particle  Hazards 

The  following  example  demonstrates  the  use  of  the  DMSP  aurora  Seienee  Module  (AURORA), 

the  CURES  eleetron  and  proton  radiation  belt  flux  Seienee  Modules  (CRRESELE,  CRRESPRO), 

the  Satellite  Applieation  Module  (SATEL-APP),  and  a  variety  of  visualization  tools  ineluding 

animated  satellite  orbits,  links,  and  deteetor  eones. 

Goal:  View  auroral  eleetron  preeipitation  patterns  and  the  3-D  distribution  of  1 .6  MeV 

eleetrons  and  10.7  MeV  proton  radiation  belt  fluxes  during  magnetieally  aetive  times 
relative  to  spaeeeraft  in  Low,  Medium,  Geosynehronous,  and  High  Earth  Orbit  (a.k.a., 
LEO,  MEO,  GEO,  and  HEO).  Build  satellite -to-ground  oommunieations  links  and 
satellite  deteetor  eones. 

Start  an  AF-GEOSpaee  session  and  set  global  input  parameters, 

•  Initiate  AF-GEOSpaee  via  the  Start  menu  {Start>Progmms>AFGeospace>AFGeospace), 
the  desktop  ieon,  or  by  double-choking  on  the  fde  $AFGS_HOME\bm\AFGeospace.bat. 
Maximize  the  AF-GEOSpace  user  interface  window.  The  shell  windows  can  be  minimized 
but  must  remain  open  for  AF-GEOSpace  to  function. 

•  For  this  run,  set  the  date  and  time  in  the  Environment  Window  by  editing  the  text  boxes  to 
read:  Start:Year=\996,  Day=3\5,  and  f/7'=18:00.  Select  the  Archive  option  using  the  Globals 
selector  to  the  right  of  the  time  inputs  and  the  values  of  the  Kp  geomagnetic  index,  sunspot 
number  (SSN),  F10.7  cm  radio  flux,  and  the  Ap  geomagnetic  index  for  this  time  will  be 
copied  from  archived  NGDC  parameters  {Kp=\J,  S'S7V=12,  F  10.7=69. 6,  SLnAAp=6).  Reset 
Kp=5.9  and  Ap=25  to  represent  a  magnetically  active  period  by  manually  editing  the 
corresponding  text  boxes. 

Create  a  3-D  graphic  of  the  Earth  with  the  Air  Force  Research  Laboratory  location  displayed, 

•  Select  the  Graphics  option  in  the  Module  menu  and  Available  Modules  and  Active  Modules 
lists  will  appear.  Scroll  down  the  Available  Modules  list  and  select  Earth.  An  Earth  object 
will  be  added  to  the  Active  Modules  list  and  a  set  of  Earth  Options  will  appear  in  the 
Environment  Window. 

•  Under  Outline  Detail,  leave  Geographic  Bndys  selected.  Under  Grid  Options  select  Lat/Lon 
Grid.  Check  the  Display  box  and  the  Earth  globe  will  appear  in  the  default  3D  window. 

•  To  place  a  station  marker  representing  the  location  of  AFRL,  scroll  down  the  Available 
Modules  list  and  select  Station  and  a  Station  object  will  be  added  to  the  Active  Modules  list. 
Highlight  the  AFRL  entry  in  the  Stations  list  and  click  Display  and  an  AFRL  label  should 
appear  in  the  3D  window  at  the  location  (Alt  (Re)=  1.0,  Eat  =  42.30,  and  Lon  =  -71.05) 
representing  AFRL.  Note:  Station  entries  can  be  added  by  editing  the  four  text  boxes  and 
clicking  the  Add  button.  Stations  can  be  removed  from  the  list  by  highlighting  the  entry  in  the 
Stations  list  and  clicking  on  the  Delete  button.  The  Pop  Label  control  can  be  used  to  make 
the  station  always  visible.  All  changes  to  the  Stations  list  will  be  saved  for  future  sessions. 

•  With  no  data  plotted,  use  the  Viewport  menu  to  turn  off  Show  Color  Bar. 
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•  The  Earth’s  size  ean  be  sealed  in  the  3D  Window  using  the  right  mouse  button.  With  the 
eursor  in  the  3D  Window,  depress  the  right  button  and  draw  the  mouse  toward  yourself. 
Rotate  the  Earth  so  that  the  AERL  loeation  marker  is  visible  by  depressing  the  left  button  and 
moving  the  mouse  sideways. 

Display  a  Time/Date  Eabel  in  the  Active  Graphic  Window, 

•  Select  Annotation  from  the  Available  Modules  list.  An  Annotation  object  will  be  added  to  the 
Active  Modules  list  and  a  set  of  Annotation  Options  will  appear  in  the  bottom  of  the 
Environment  Window.  To  display  a  time  label  in  the  graphics  window,  place  a  check  mark  in 
the  Show  Date  box  and  click  Display  and  a  time/date  label  will  appear  in  the  far  lower  left 
comer  of  the  graphic  window.  Move  ihs  X Position  and  Y  Position  sliders  to  a  value  of 
approximately  0.04  to  make  them  easier  to  read. 

Create  and  display  an  orbiting  Eow  Earth  Orbit  (EEO)  satellite, 

•  Select  the  Applications  option  from  the  Module  menu  and  Available  Modules  and  Active 
Modules  lists  will  appear.  Scroll  down  the  Available  Modules  list  and  click  on  SATEL-APP . 

A  SATEE-APP  object  will  be  added  to  the  Active  Modules  list  and  a  set  of  Ephemeris  Data 
options  will  appear  in  the  Environment  Window. 

•  Under  Propagator  leave  the  Lokangle  option  set  and  under  Element  Type  choose  the  Mean 
option.  Edit  the  text  boxes  that  appear  so  that  Inclination=9S.5S3,  Arg.  ofPerigee=\  14.661, 
Mean  Anomaly=246.292,  Eccentricity=0. OOOS,  R.A.  Asc.  Node=  19.714,  svaAMean  Motion  = 
14.327  (leave  d(MM)/dt/2,  d2(MM)/dt2/6,  anABSTAR  at  their  default  values).  Set  the  orbit 
reference  time  by  editing  the  T_reftQxt  box  to  read  “1 1/04/96  19:48:29”.  Type  “EEO”  in  the 
Sat.  Name  text  box  and  leave  Time  Step  (s)  set  at  60  seconds.  Select  the  Run/Update  option 
in  the  Edit  menu  and  a  Process  View  Window  will  appear  as  orbit  data  are  generated.  Note: 
Example  2  demonstrates  the  use  of  From  File  feature  which  is  not  as  general  but  much 
simpler  to  use. 

•  Select  the  Graphics  option  from  the  Module  menu  and  Available  Modules  and  Active 
Modules  lists  will  appear.  Scroll  down  the  Available  Modules  list  and  select  Satellite.  A 
Satellite  object  will  be  added  to  the  Active  Modules  list  and  a  set  of  Satellite  Options  will 
appear. 

•  Click  on  the  Satellite  button  and  select  the  option  LEO,  leave  the  Data  button  set  to  No  Date, 
use  the  Label  selector  to  choose  Sat.  Name,  and  check  Pop  Marker.  Under  Reference  Erame 
place  a  check  next  to  Inertial  (ECI)  and  uncheck  Geocentric  (GEOC).  Click  on  in  the 
Display  box  and  the  EEO  satellite  will  appear  in  orbit  near  Antarctica  (under  India)  in  the  3D 
Window. 

•  Select  the  Animate  Tool  option  in  the  Edit  menu  and  an  Animate  window  will  appear.  Click 
the  Find  Range  button  to  allow  the  animator  to  register  the  times  span  covered  by  the  orbit 
generated.  Use  the  right  arrow  on  the  time  slider  until  you  reach  “1 1/1 1/96  06:00”  and  the  3D 
Window  should  resemble  the  figure  below. 
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•  Edit  the  Time  Step  text  box  to  read  “300”,  eliek  on  the  Update  button,  and  then  eliek  the 
Animate  button  under  the  slider  and  the  ehanging  LEO  satellite  position  will  be  displayed  at 
300  seeond  intervals.  Clieking  the  Animate  button  again  halts  the  animation.  The  Done 
button  will  halt  the  animation  and  dismiss  the  Animation  Window. 

Create  and  Display  an  AURORA  Seienee  Module  data  set, 

•  Select  the  Science  option  in  the  Module  menu  and  Available  Modules  and  Active  Modules 
lists  will  appear.  Click  on  AURORA  in  the  Available  Modules  list  and  a  SciAurora  object  will 
be  added  to  the  Active  Modules  list.  A  set  of  AURORA  Options  will  appear  in  the 
Environment  Window. 

•  Leave  all  AURORA  Options  set  at  the  default  values.  Select  the  Run/Update  option  in  the 
Edit  menu  and  a  Process  View  Window  appears  momentarily.  When  the  model  is  complete, 
this  window  disappears  and  the  Model  Status  box  will  indicate  that  the  Global  Parameters 
Day,  Time,  and  Kp  were  used  and  the  “MODEL  IS  READY  AND  UP  TO  DATE.” 

•  Select  the  Graphics  option  in  Module  menu  and  Available  Modules  and  Active  Modules  lists 
will  appear.  Scroll  up  the  Available  Modules  list,  select  Coord  Slice,  and  a  Coord  Slice  object 
will  be  added  to  the  Active  Modules  list.  A  set  of  Coord  Slice  Options  will  appear  in  the 
Environment  Window.  The  Cut  Plane  options  CO,  Cl,  and  C2  correspond  to  the  three 
spherical  coordinates  used  when  building  the  aurora  data  set.  Use  the  default  setting  called 
CO  to  slice  the  data  at  a  constant  radius. 

•  Click  the  Data  button,  go  to  the  SciAurora  option,  and  select  Elec.  Number  Flux.  Click  in  the 
Display  box  and  auroral  electron  data  will  appear  in  the  3D  Window.  Prom  the  Viewport 
menu,  use  the  Show  Color  Bar  option  to  show  the  color  bar  with  units  now  representing 
auroral  electron  number  flux. 

•  To  make  the  auroral  display  more  transparent,  click  the  Transparency  button  in  the 
Environment  Window  and  move  the  slider  to  a  value  of  0.70.  Rotate  the  Earth  and  notice  that 
the  auroral  electron  number  flux  is  displayed  at  both  poles.  To  see  more  detail  on  the 
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continents,  highlight  the  Earth  entry  in  the  Active  Modules  list  on  the  right  and  eheek-off 
Textured  in  the  Outline  Detail  seetion  of  the  Earth  Options  inputs. 

•  Use  the  Viewport  menu  to  seleet  Projection  and  then  its  Two  D  option  (the  Three  D  option 
will  eonvert  it  baek  to  a  3D  window).  To  get  the  AURORA  eolor  bar  to  reappear  highlight 
the  Coord  Slice  entry  in  the  Active  Modules  list  on  the  right  (or  hold  down  the  Ctrl  key  and 
eliek  the  mouse  on  the  eolored  eleetron  preeipitation  data  in  the  graphie  window).  The 
window  should  resemble  the  following  figure. 


•  Use  the  Viewport  menu  to  seleet  Projection  and  then  its  Three  D  option  to  transform  the  view 
baek  to  3D. 

Create  a  CRRESELE  Seienee  Module  data  set, 

•  Seleet  the  Science  option  from  the  Module  menu  and  Available  Modules  and  Active  Modules 
lists  will  appear.  Cliek  on  CRRESELE  in  the  Available  Modules  list.  A  SciCrresEle  objeet 
will  be  added  to  the  Active  Modules  list  and  a  set  of  CRRESEEE  Options  will  appear. 

•  Cliek  on  the  B-Model  button  and  seleet  Dip-Tilt-Ojf.  This  is  not  the  magnetie  field  model 
originally  used  to  reduee  the  CRRES  data  but  will  suffiee  for  this  example.  Erom  the  Energy 
Channel  (MeV)  list,  seleet  1.6  MeV  and  from  the  Apl5  Model  Range  list,  seleet  the  Apl5 
20.0  -  25.0  option.  Eeave  the  Compute  button  alone. 

•  Seleet  the  Run/Update  option  in  the  Edit  menu  and  a  Process  View  Window  will  appear 
while  CRRESEEE  is  running.  When  the  model  is  eomplete  that  window  will  disappear  and 
the  model  inputs  will  appear  in  the  Model  Status  box  at  the  bottom  of  the  Environment 
Window  with  the  message  “MODEE  IS  READY  AND  UP  TO  DATE.” 
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Display  two  CRRESELE  data  coordinate  slices  at  constant  longitude, 


•  Select  the  Graphics  option  in  the  Module  menu  and  Available  Modules  and  Active  Modules 
lists  will  appear.  Click  on  Coord  Slice  in  the  Available  Modules  list  and  a  second  Coord  Slice 
object  will  be  added  to  the  Active  Modules  list.  A  set  of  Coord  Slice  Options  will  appear  in 
the  Environment  Window. 

•  Click  the  Data  button  and  select  Flux  under  the  SciCrresEle  option.  Select  the  Cut  Plane  C2 
to  slice  the  CRRESEEE  data  at  a  constant  longitude.  Click  on  Display  and  CRRESEEE  data 
appear  near  -180  degrees  Longitude.  Move  the  Position  Value  slider  until  the  longitude  value 
displayed  under  the  slider  is  approximately  zero. 

•  Notice  that  the  color  bar  units  now  represent  CRRESELE  electron  number  flux.  In  general, 
the  color  bar  units  correspond  to  the  graphics  object  currently  highlighted  in  the  Active 
Modules  list  and  the  input  options  displayed  in  the  Environment  window.  To  quickly  regain 
the  color  bar  corresponding  to  the  aurora  data,  depress  the  Ctrl  key  and  click  the  left  mouse 
button  on  the  auroral  data.  This  action  will  restore  the  AURORA  environment  window  also. 

•  Click  again  on  Coord  Slice  in  the  Available  Modules  list  and  a  third  Coord  Slice  object  will 
be  added  to  the  Active  Modules  list.  A  set  of  Coord  Slice  options  will  appear  in  the 
Environment  Window.  Click  the  Data  button  and  select  Flux  under  the  SciCrresEle  option. 
Select  the  Cut  Plane  option  C2,  click  on  Display,  and  CRRESELE  data  appears  again  near 
180  degrees  Longitude.  There  are  now  two  electron  belt  coordinate  slices  on  opposite  sides 
of  the  Earth. 

Renaming  Like -Named  Objects  in  the  Active  Modules  List, 

•  To  help  keep  track  of  which  Active  Modules  entry  corresponds  to  which  graphic  element, 
AE-GEOSpace  contains  a  renaming  feature.  This  example  now  has  three  Coord  Slice  entries 
in  the  Active  Modules  list  on  the  right,  one  for  the  AURORA  and  two  for  CURES -ELE  data. 
Highlight  the  first  Coord  Slice  entry  in  the  Active  Modules  list,  select  the  Rename  option  in 
the  Edit  menu  and  a  Rename  Model  window  appears.  Edit  the  Name  text  box  to  read 
“Aurora”  and  click  OK  to  change  the  Coord  Slice  entry’s  name.  Repeat  the  process  with  the 
remaining  two  Coord  Slice  entries  in  the  Active  Modules  list  and  rename  them  “CRRES¬ 
ELE  1”  and  “CRRES-ELE2”.  Because  more  orbits  will  be  generated  below,  highlight  the 
Satellite  entry  and  rename  it  “LEO”. 

Create  a  CRRESPRO  Science  Module  data  set, 

•  Select  the  Science  option  in  the  Module  menu  and  Available  Modules  and  Active  Modules 
lists  will  appear.  Click  on  CRRESPRO  in  the  Available  Modules  list.  A  SciCrresPro  object 
will  be  added  to  the  Active  Modules  list  and  a  set  of  CRRESPRO  Options  will  appear. 

•  Click  on  the  B-Model  button  and  select  Dip-Tilt-Ojf.  Again,  this  is  not  the  magnetic  field 
model  originally  used  to  reduce  the  CURES  data  but  will  suffice  for  this  example.  Erom  the 
Energy  Channel  (MeV)  list  select  10.7  MeV  and  use  the  Activity  button  to  select  the  Active 
option. 
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•  Select  the  Run/Update  option  from  the  Edit  menu  button  and  a  Process  View  Window  will 
appear  while  CRRESPRO  is  running.  When  the  model  is  complete  that  window  will 
disappear  and  the  model  inputs  will  appear  in  the  Model  Status  box  at  the  bottom  of  the 
Environment  Window  along  with  the  message  “MODEL  IS  READY  AND  EIP  TO  DATE.” 

Display  two  CRRESPRO  data  coordinate  slices  at  constant  longitude, 

•  Select  the  Graphics  option  in  the  Module  menu  and  Available  Modules  and  Active  Modules 
lists  will  appear.  Click  on  Coord  Slice  in  the  Available  Modules  list  and  a  Coord  Slice  object 
will  be  added  to  the  Active  Modules  list.  A  set  of  Coord  Slice  options  will  appear  in  the 
Environment  Window. 

•  Click  the  Data  button  and  select  Flux  under  the  SciCrresPro  option.  Select  the  Cut  Plane 
option  C2  to  slice  the  CRRESPRO  data  at  a  constant  longitude.  Click  on  Display  and 
CRRESPRO  data  appears  near  180  degrees  Longitude.  The  units  for  the  color  bar  now 
represent  CRRESPRO  proton  number  flux.  Select  Rename  from  the  Edit  menu  and  enter 
“CRRES-PROl”  as  the  new  coordinate  slice  name. 

•  Click  on  Coord  Slice  in  the  Available  Modules  list  and  a  Coord  Slice  object  will  be  added  to 
the  Active  Modules  list  under  CRRES-PR02 .  A  set  of  Coord  Slice  Options  will  appear  in  the 
Environment  Window. 

•  Click  the  Data  button  and  select  Flux  under  the  SciCrresPro  option.  Select  the  “Coordinate” 
C2  to  slice  the  data  at  constant  longitude  and  click  on  Display.  CRRESPRO  data  appears 
again  near  180  degrees  Longitude.  Move  the  Position  Value  slider  to  read  approximately  0.5. 
This  places  the  proton  data  slice  just  west  of  the  nearby  electron  data. 

•  To  make  more  room  for  the  data  displayed,  go  to  the  Viewport  menu  and  turn  off  the  Show 
Color  Bar  feature.  The  figure  should  now  resemble  the  following  figure. 
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Create  and  display  a  Medium  Earth  Orbit  (MEO)  data  set  with  a  communieations  link  to  AERE, 

•  Seleet  the  Applications  option  in  the  Module  menu  and  Available  Modules  and  Active 
Modules  lists  will  appear.  Click  on  SATEL-APP  in  the,  Available  Modules  list.  A  second 
AppSatel  object  will  be  added  to  the  Active  Modules  list  and  a  set  of  Ephemeris  Data  options 
will  appear  in  the  Environment  Window. 

•  Under  Propagator  leave  Lokangle  selected  and  under  Element  Type  choose  the  option  Mean. 
Edit  the  text  boxes  that  appear  so  that  Inclination=55 .051 ,  Arg.  of  Perigee  =  203.685,  Mean 
Anomaly=\56.036,  Eccentricity=0.001,  R.A.  Asc.  AoJe=314.183,  andMean  Motion  =  2.006 
(leave  d(MM)/dt/2,  d2(MM)/dt2/6,  and  BSTAR  at  their  default  values.  Edit  the  orbit  reference 
time  so  that  the  T_reftQxt  box  reads  “1 1/04/96  08:44:20”.  Type  “MEO”  in  the  Sat.  Name  text 
box  and  leave  Time  Step(s)  set  at  60.  Use  the  Edit  menu  to  Rename  this  application  entry 
“MEO”. 

•  Select  the  Run/Update  option  in  the  Edit  menu  and  a  Process  View  Window  will  appear  as 
orbit  data  are  generated.  Select  the  Graphics  option  in  the  Module  menu  and  Available 
Modules  and  Active  Modules  lists  will  appear.  Scroll  down  the  Available  Modules  list  and 
click  on  Satellite.  A  Satellite  object  will  be  added  to  the  Active  Modules  list  and  a  set  of 
Satellite  Options  will  appear  in  the  Environment  Window. 

•  Use  the  Satellite  button  to  select  MEO,  leave  Data  set  to  off,  use  the  Label  button  to  select 
Sat.  Name,  and  check  Pop  Marker.  Under  Reference  Erame,  check  Inertial  (ECI)  and 
uncheck  Geocentric  (GEOC).  Click  in  the  Display  box  and  the  MEO  orbit  will  appear  in  the 
3D  Window.  Use  the  Edit  menu  to  Rename  the  Satellite  entry  as  “MEO” 

•  Scroll  down  the  Available  Modules  list  and  select  Link.  A  Link  object  will  appear  in  the 
Active  Modules  list  and  Link  options  will  appear  in  the  Environment  Window.  Highlight  the 
AERL  entry  in  one  of  the  Station  lists  and  highlight  MEO  in  the  other  Station  list.  Click  the 
Display  box  to  create  the  line-of-sight  link  connecting  AERL  to  the  MEO  satellite. 

•  If  AERL  and  the  MEO  satellite  are  not  within  line-of-sight  of  each  other,  select  the  Animate 
Tool  in  the  Edit  menu  to  use  the  Animate  Window.  Move  the  slider  in  the  Animate  window 
until  you  will  notice  that  the  link  line  will  appear  only  when  the  MEO  satellite  is  within  line- 
of-sight  of  AERL.  Click  on  the  Done  button  to  retire  the  Animate  window. 

Create  and  display  a  High  Earth  Orbit  (HEO)  data  set  with  a  downward  looking  detector  cone, 

•  Select  the  Applications  option  from  the  Module  menu  and  Available  Modules  and  Active 
Modules  lists  will  appear.  Click  on  SATEL-APP  in  das  Available  Modules  list.  Nn  AppSatel 
object  will  be  added  to  the  Active  Modules  list  and  a  set  of  Ephemeris  Data  options  will 
appear  in  the  Environment  Window. 

•  Under  Propagator  leave  the  Lokangle  option  selected  and  choose  Mean  under  Element  Type. 
Edit  the  text  boxes  that  appear  so  that  Inclination=S6. 302,  Arg.  ofPerigee=  278.085,  Mean 
Anomaly=22.234,  Eccentricity=0 .633%,  R.A.  Asc.  Node=24.922,  andMean  Motion  =  1.362 
(leave  d(MM)/dt/2,  d2(MM)/dt2/6,  and  BSTAR  at  their  default  values).  Adjust  the  orbit 
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reference  time  by  editing  the  T_reftQxt  box  to  read  “10/29/96  17:06:38”.  Type  “HEO”  in  the 
Sat.  Name  text  box  and  leave  Time  Step(s)  =  60.  Use  the  Edit  menu  to  Rename  this  entry 
“HEO”. 

Select  the  Run/Update  option  in  the  Edit  menu  and  a  Process  View  window  will  appear,  then 
vanish  and  the  Model  Status  box  will  say  the  “MODEE  IS  READY  AND  UP  TO  DATE.” 

Select  the  Graphics  option  in  the  Module  menu  and  Available  Modules  and  Active  Modules 
lists  will  appear.  Scroll  down  and  click  on  Satellite  in  the  Available  Modules  list.  A  Satellite 
object  will  be  added  to  the  Active  Modules  list  and  a  set  of  Satellite  Options  will  appear. 

Select  ElEO  with  the  Satellite  button,  leave  the  Data  button  set  to  off,  use  the  Label  button  to 
select  Sat.  Name,  and  check  Pop  Marker.  Under  Reference  Erame  check  Inertial  (ECI)  and 
uncheck  Geocentric  (GEOC).  Use  the  Edit  menu  to  Rename  the  Satellite  entry  as  “HEO” 

Scroll  up  in  the  Available  Modules  list  and  select  Detector.  A  Detector  object  will  appear  in 
the  Active  Modules  list  and  Detector  option  will  appear  in  the  Environment  Window. 
Highlight  the  HEO  entry  in  the  Origin  Station  list  by  clicking  on  it.  Move  the  View  Angle 
slider  (or  edit  the  text  box)  until  the  angle  equals  7  degrees.  Click  on  Display  and  the  detector 
cone  should  appear  coming  from  the  HEO  satellite.  Click  the  Transparency  button  and  move 
the  slider  that  appears  to  a  value  of  0.70  to  make  the  cone  slightly  transparent.  As  with  the 
Eink  visualized  above,  you  can  open  the  Animate  Tool  in  the  Edit  menu  and  move  the 
Animate  Window  slider  around  to  see  the  detector  cone  at  different  positions. 

A  better  picture  of  the  detector’s  footprint  can  be  viewed  by  simply  changing  the 
dimensionality  of  the  active  3D  window.  Open  the  Viewport  menu  and  slide  down  to  the 
Projection  item  and  select  the  Two  D  option.  Again,  the  Animate  Tool  in  the  Edit  menu  can 
be  used  to  see  how  the  detector  visualization  changes  with  time.  Note  that  the  detector 
footprint  in  2D  can  breakup  near  the  poles.  Move  the  Animate  Window  time  slider  to  read 
“1 1/1 1/96  16:15”  and  the  2D  display  should  resemble  the  next  figure.  Switch  back  to  3D 
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with  the  Viewport  menu  by  seleeting  Projection  and  then  Three  D. 

Create  and  display  a  Geosynehronous  Orbit  (GEO)  data  set  with  a  deteetor  eone, 

•  Seleet  the  Applications  option  in  the  Module  menu  and  Available  Modules  and  Active 
Modules  lists  will  appear.  Cliek  on  SATEL-APP  in  ths  Available  Modules  list.  An  AppSatel 
objeet  will  be  added  to  the  Active  Modules  list  and  a  set  of  Ephemeris  Data  options  will 
appear  in  the  Environment  Window. 

•  Under  Propagator  leave  Lokangle  seleeted  and  ehoose  Mean  under  Element  Type.  Edit  the 
text  boxes  that  appear  so  that  lnclination=0. 1233,  Arg.  of  Perigee=332.65 1 ,  Mean 
Anomaly=263.6\S,  Eccentricity=0. 0004,  R.A.  Asc.  Node=266.253,  andMean  Motion  =  1.003 
(leave  d(MM)/dt/2,  d2(MM)/dt2/6,  and  BSTAR  at  their  default  values).  Edit  the  orbit 
referenee  time  so  that  the  T_ref  text  box  reads  “1 1/04/96  15:31 :55”.  Type  “GEO”  in  the  Sat. 
Name  text  box  and  leave  Time  Step(s)  set  at  60  seeonds.  Use  the  Edit  menu  to  Rename  this 
applieation  entry  “GEO”. 

•  Seleet  the  Run/Update  option  in  the  Edit  menu  and  a  Process  View  Window  appears  briefly 
and  the  Model  Status  box  will  indieate  “MODEE  IS  READY  AND  UP  TO  DATE.” 

•  Seleet  the  Graphics  option  in  the  Module  menu  and  Available  Modules  and  Active  Modules 
lists  will  appear.  Cliek  on  Satellite  in  the  Available  Modules  list  and  a  Satellite  objeet  will  be 
added  to  the  Active  Modules  list  and  a  set  of  Satellite  Options  will  appear  in  the  Environment 
Window. 

•  Use  the  Satellite  button  to  seleet  GEO,  leave  the  Data  button  set  to  No  Date,  use  the  Label 
button  to  seleet  Sat.  Name,  and  eheek  Pop  Marker.  Under  Referenee  Erame  eheek  Inertial 
(ECI)  and  uneheek  Geocentric  (GEOC).  Cliek  the  Display  box  and  the  GEO  orbit  will  appear 
over  the  Paeifie  Oeean  in  the  3D  Window.  Eor  eompleteness,  use  the  Edit  menu  to  Rename 
this  graphie  entry  “GEO”. 

•  To  assoeiate  a  deteetor  eone  with  the  GEO  satellite,  seroll  up  in  the  Available  Modules  list 
and  seleet  Detector.  A  seeond  Detector  objeet  will  appear  in  the  Active  Modules  list  and 
Deteetor  option  will  appear  in  the  Environment  Window.  Seroll  down  the  Origin  Station  list 
and  highlight  the  GEO  entry  by  elieking  on  it.  Move  the  View  Angle  slider  (or  edit  the  text 
box)  until  the  angle  equals  8  degrees.  Cliek  on  Display  and  the  deteetor  eone  should  appear 
eoming  from  the  HEO  satellite.  Uneheek  the  Solid  box  to  produee  a  wire  frame  rendering  of 
the  deteetor. 

Display  an  Annotation  Eabel  in  the  Aetive  Graphie  Window, 

•  Seleet  the  Graphics  option  in  the  Modules  menu  and  Available  Modules  and  Active  Modules 
lists  will  appear.  SQlQCi  Annotation  from  ths  Available  Modules  list.  An  Annotation  objeet 
will  be  added  to  the  Active  Modules  list  and  a  set  of  Annotation  Options  will  appear  in  the 
bottom  of  the  Environment  Window. 
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•  Edit  the  Text  field  to  read  “AF-GEOSPACE”  and  eliek  Display  and  the  label  will  appear  in 
the  far  lower  left  comer  of  the  graphic  window.  Move  i\\Q  X Position  slider  to  0.04  and  the  Y 
Position  sliders  to  approximately  0.90  to  place  it  in  the  upper  left  of  the  graphic  window. 


•  Move  the  Animate  Window  time  slider  to  read  “1 1/10/96  22:25”  and  the  3D  display  should 
resemble  the  figure  above. 

While  the  HEO  detector  is  scanning  the  aurora  over  Alaska,  the  MEO  satellite  is  entering  the 
heart  of  the  1.6  MeV  electron  radiation  belt  and  is  in  line-of-sight  of  AFRE.  The  EEO  satellite  is 
moving  southward  over  equator  in  the  Pacific  while  the  GEO  satellite  detector  is  still  monitoring 
a  nearby  patch  of  open  water. 

This  completes  the  Example  of  Space  Particle  Hazards. 
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2)  Low  Earth  Orbit  Particle  Environment 

This  example  demonstrates  the  use  of  the  CRRES  proton  (CRRESPRO)  and  the  CRRES  electron 
(CRRESELE)  radiation  belt  flux  Science  Modules,  the  DMSP  Aurora  Science  Module 
(AURORA),  the  Satellite  Application  Module  (SATEL-APP),  and  a  variety  of  graphical  tools. 

Goal:  Demonstrate  the  spatial  distribution  of  the  particle  populations  encountered  by  the 
Defense  Meteorological  Satellite  Program  (DMSP)  satellite  (in  a  low  Earth  orbit), 
including  the  low  altitude  projections  of  the  inner  and  outer  radiation  belts  as  well  as 
the  auroral  oval.  It  will  be  shown  that  the  inner  belt  protons  penetrate  to  DMSP 
altitude  in  a  localized  region  above  the  South  Atlantic  (South  Atlantic  Anomaly)  due 
to  the  asymmetry  of  the  Earth’s  magnetic  field.  A  low  altitude  projection  of  the  outer 
radiation  belt  electrons  appears  in  both  hemispheres  and  the  particle  flux  from  the 
magnetosphere’s  plasma  sheet  precipitates  into  the  ionosphere  forming  the  high 
latitude  auroral  oval.  Both  2D  and  3D  representations  of  these  populations,  along  with 
a  trace  of  a  DMSP  orbit,  will  be  shown  juxtaposed  over  the  Earth.  ID  flux  plots 
versus  time  will  also  be  generated  for  each  of  the  three  populations. 

Procedure  Summary:  Section  1  starts  a  Static  Model  session.  Sections  2-4  generate  the 
CRRESPRO,  CRRESELE,  and  AURORA  Science  Module  data  sets.  Section  5  generates  the 
DMSP  orbit  data  set.  Section  6  creates  a  2D  and  a  3D  view  of  the  Earth  with  a  superimposed 
DMSP  orbit.  Section  7  creates  a  2D  view  of  the  particle  environment.  Section  8  creates  a  3D 
view  of  the  particle  environment,  and  Section  9  creates  a  ID  plot  of  flux  vs.  time  for  the  DMSP 
orbit. 

1)  Start  an  AF-GEOSpace  session  and  set  global  input  parameters, 

•  Initiate  AF-GEOSpace  via  the  Start  menu  {Start>Progmms>AFGeospace>AFGeospace), 
the  desktop  icon,  or  by  double-clicking  on  the  file  $AFGS_HOME\bin\AFGeospace.bat. 
Maximize  the  AF-GEOSpace  user  interface  window.  The  shell  windows  can  be  minimized 
but  must  remain  open  for  AF-GEOSpace  to  function. 

•  For  this  run,  set  the  date  and  time  by  editing  the  Globals  text  boxes  to  read:  Start:  Year  = 
1997,  Day  =  200,  and  UT=  10:30  (Day  200  =  19  July).  Click  on  the  Archive  option  of  the 
Globals  button  and  the  values  of  the  Kp  geomagnetic  index,  sunspot  number  (SSN),  F10.7 
cm  radio  flux,  and  the  Ap  geomagnetic  index  that  have  been  archived  by  NGDC  will  be 
retrieved  for  the  appropriate  time  {Kp=\.l,  S'57V=0,  FI 0.7=12.%,  andAp=6). 

2)  Create  a  CRRESPRO  Science  Module  (inner  proton  belt)  data  set, 

•  Choose  Module  from  the  Environment  Window  Menu  Bar  and  select  Science  from  the 
options.  Available  Modules  and  Active  Modules  lists  will  appear.  Click  on  CRRESPRO  in  the 
Available  Modules  list.  A  SciCrresPro  object  will  be  added  to  the  Active  Modules  list  and  a 
set  of  CRRESPRO  Options  will  appear  in  the  Environment  Window. 

•  Scroll  down  the  Energy  Channel  (MeV)  list  select  the  47.0  MeV  channel. 
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•  Click  on  the  B-Model  button  and  select  the  IGRF85  option  to  generate  a  realistically 
positioned  South  Atlantic  Anomaly  (SAA)  for  Low  Earth  Orbit  (LEO)  altitudes  relatively 
quickly.  Note  that  the  IGRF85/0-P  model  was  used  to  construct  CRRESPRO  but  take  longer 
to  run.  Also,  while  the  offset-tilted  dipole  option  Dip-Tilt-Off  is  fastest,  it  does  not  yield  a 
realistically  positioned  SAA.  Leave  the  Activity  button  set  to  the  Quiet  model  option.  The 
Quiet  model  contains  only  the  primary  inner  belt  and  is  more  typical  of  the  inner 
magnetosphere.  The  Active  model  was  constructed  from  CURES  data  following  the  24 
March  1991  magnetic  storm  and  contains  the  second  proton  belt. 

•  Select  the  Grid  Tool  option  in  the  Edit  menu  and  the  Grid  Tool  window  will  appear.  Leave 
unchanged  the  default  grid  Spacing,  Geometry,  and  coordinate  System  in  order  to  generate  a 
linearly  spaced  spherical  grid  defined  by  radius,  geocentric  latitude,  and  geocentric  longitude. 
Increase  all  three  Npoint  text  boxes  from  values  of  20  to  40.  In  the  Rad,  GEOC  (Re)  section 
set  Mm=I  .0  and  Afax=3.0.  Close  the  Grid  Tool  Window  by  clicking  the  OK  button. 

•  Select  the  Run/Update  option  in  the  Edit  menu.  A  Process  View  Window  will  appear  while 
CRRESPRO  is  running  and  then  disappear.  Identification  and  status  of  the  model  will  appear 
in  the  Model  Status  box  in  the  lower  part  of  the  window. 

3)  Create  a  CRRESELE  Science  Module  (outer  electron  radiation  belt)  data  set, 

•  Click  on  CRRESELE  in  the  Available  Modules  list.  A  SciCrresEle  object  will  be  added  to  the 
Active  Modules  list  and  a  set  of  CRRESELE  Options  will  appear.  Erom  the  Energy  Channel 
(MeV)  list  select  the  1.6  MeV  channel.  Click  on  the  B-Model  button  and  select  the  IGRF85 
model  as  was  done  for  CRRESPRO.  Prom  the  Apl5  Model  Range  list,  choose  Apl5  7.5  - 
10.0  to  approximate  the  global  value  of  7.56  (shown  below  the  Compute  button)  which  was 
determined  for  day  200/1997.  This  will  select  a  model  constructed  from  CRRES  data  during 
those  time  intervals  when  the  average  value  of  daily  Ap  over  the  preceding  15  days  was 
between  7.5  and  10. 

•  Select  the  Grid  Tool  option  in  the  Edit  menu  and  the  Grid  Tool  window  will  appear.  Under 
Rad,  GEOC  (Re)  set  Npoint=60,  Min=\.0,  andMax=7.0.  Under  Eat,  GEOC  (Deg  N)  set 
Npoint=60,  Min=  -85,  andMax=75.  Under  Lon,  GEOC  (Deg  E)  set  Npoint=40,  Min=  -180, 
andMax=180.  Close  the  Grid  Tool  window  by  clicking  the  OA  button. 

•  Select  the  Run/Update  option  in  the  Edit  menu  and  a  Process  View  window  will  appear  while 
CRRESELE  is  running.  When  the  model  is  complete  the  window  will  disappear  and  the 
identification  and  status  of  the  model  will  appear  in  the  Model  Status. 

4)  Create  an  AURORA  Science  Module  data  set, 

•  Click  on  A  URORA  in  the  Available  Modules  list  and  a  SciAurora  object  will  be  added  to  the 
Active  Modules  list.  Within  the  set  of  AURORA  Options  appearing  in  the  Environment 
Window,  select  the  Fast  IGRE  option  under  Internal  B-Pield  and  leave  all  other  settings 
unchanged. 
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•  Select  the  Grid  Tool  option  in  the  Edit  menu.  The  default  is  a  two-dimensional  latitude- 
longitude  grid  at  a  constant  radius  of  1.0173  Earth  radii.  This  is  the  original  domain  on  which 
the  aurora  model  was  constructed.  Under  Rad,  GEOC  (Re)  set  Npoint=2,  leave  Mm=1.0173, 
and  reset  Max=  1 . 1 4  Re  to  bracket  the  DMSP  altitude  of  840  km  (1.1318  Re).  Set  Npoint 
equal  to  80  in  the  Eat,  GEOC  (Deg  N)  and  Eon,  GEOC  (Deg  E)  sections.  Close  the  Grid  Tool 
window  by  clicking  on  the  OK  button. 

•  Select  the  Run/Update  option  in  the  Edit  menu.  When  the  model  is  complete  the  Process 
View  window  will  disappear  and  the  Model  Status  box  will  be  updated  indicate  that  the 
Global  Parameters  Day,  Time,  and  Kp  are  being  used  to  construct  the  model. 

5)  Create  the  DMSP  orbit  data  set, 

•  Select  the  Applications  option  in  the  Module  menu.  Available  Modules  and  Active  Modules 
lists  will  appear.  Scroll  down  the  Available  Modules  list  and  select  SATEL-APP  (satellite 
application).  An  AppSatel  object  will  be  added  to  the  Active  Modules  list  and  a  set  of 
Ephemeris  Data  options  will  appear  in  the  Environment  Window. 

•  With  the  Prom  Pile  Element  Type  selected,  click  on  the  Pile  button  and  a  window  appears 
showing  the  contents  of  the  folder  $AEGS_HOME\models\data\EPHEMERIS.  Click  on  the 
file  icon  labeled  “dmsp.txt”  and  click  the  Open  button. 

•  A  list  of  DMSP  satellites  will  appear  in  the  Current  Element  Pile  list  in  the  middle  of  the 
window.  Select  DMSP  El 4  and  the  satellite  name  and  the  reference  time  associated  with  the 
orbital  elements  are  given  in  boxes  below  the  list  box.  To  view  the  orbital  elements  for  any 
satellite  loaded  using  the  Prom  Pile  option,  click  on  the  Mean  element  type  button.  Reselect 
the  Prom  Pile  element  type  button  to  return  to  the  previous  view.  The  default  value  for  the 
start  time  {T_start)  is  taken  from  the  global  values  at  the  top  of  the  Environment  Window. 
Whenever  a  S ATEE-APP  module  is  run  in  “static”  mode,  a  1  -day  interval  with  a  60-second 
time  step  is  used  by  default. 

•  Edit  the  T_start  text  box  to  read  “07/19/97  08:30:00”  and  edit  the  T  stop  text  box  to  read 
"W 119191  12:30:00”.  Select  the  Run/Update  option  in  the  Edit  menu  to  create  the  orbit  data 
set.  When  completed,  the  Model  Status  box  will  indicate  that  the  “MODEE  IS  READY  AND 
UP  TO  DATE.” 

6)  Create  2D  and  3D  views  of  Earth  with  an  orbit  trace, 

•  Select  the  Create  2D  Viewport  option  in  the  Window  menu  and  a  2D  window  will  be  created. 
The  Window  menu  options  labeled  1:1  (the  default  3D  viewport)  and  2:2  (the  2D  viewport 
just  created)  can  be  used  to  bring  the  windows  to  the  front.  Use  the  Tile  option  in  the  Window 
menu  to  make  both  windows  viewable. 

•  Select  the  Graphics  option  from  the  Module  menu  and  Available  Modules  and  Active 
Modules  lists  will  appear.  Select  Earth  from  the  Available  Modules  list.  An  Earth  object  will 
be  added  to  the  Active  Modules  list  and  a  set  of  Earth  Options  will  appear  in  the  Environment 
Window.  Select  Outline  Detail  options  Textured  and  Geographic  Bndys.  Click  on  Display 
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and  the  Earth  will  appear  in  the  aetive  2D  window.  To  place  the  Earth  in  the  3D  window, 
simply  click  on  that  window  to  activate  it  and  select  Display  again. 

•  Scroll  down  the  Available  Modules  list  and  select  Satellite.  A  Satellite  object  will  be  added  to 
the  Active  Modules  list  and  a  set  of  Satellite  Options  will  appear.  Click  the  Satellite  list  and 
choose  DMSP  FI 4.  Click  Display  to  place  the  orbit  in  the  active  window.  To  place  the  orbit 
in  the  other  window,  simply  click  on  that  window  and  select  Display  again. 

•  Click  on  the  Label  button  and  select  the  Rad,  Lat,  Lon  option.  Radius  (1.13  Re),  latitude  (- 
81.14),  and  longitude  (-1 19.94°)  will  be  displayed  at  the  current  satellite  position  (solid  red 
circle).  Click  the  Label  button  and  select  Time.  The  coordinate  label  will  be  replaced  by  the 
day  of  year/time.  After  clicking  in  the  3D  window  to  ensure  it  is  active,  uncheck  the  Show 
Color  Bar  option  in  the  Viewport  menu  to  remove  the  color  bars  from  the  graphics  windows. 
The  3D  window  should  resemble  the  following  figure. 


•  To  move  the  satellite  along  its  orbit,  select  the  Animate  Tool  option  in  the  Edit  menu  and  an 
Animate  window  will  appear.  The  Time  Start  and  Time  End  text  field  values  in  the  Animate 
window  key  off  the  global  start  time.  Edit  these  two  windows  to  match  the  start  and  stop 
times  entered  in  the  SATEE-APP  module,  i.e.,  07/19/97  08:30  and  07/19/97  10:30.  Now 
reset  the  Time  Step  field  to  60  seconds  and  click  the  Update  button.  Moving  the  slider  until  it 
reads  07/19/97  10: 12  to  position  DMSP14  over  the  South  Atlantic  Anomaly  (SAA)  at 
“r”=1.14,  “lat”=  -29.80°,  “lon”=  -29.99°.  To  move  the  satellite  in  60-second  increments,  use 
the  left/right  arrow  buttons  located  at  the  slider  ends.  Note  that  while  the  Animate  box  under 
the  slider  is  checked,  the  satellite  will  move  continuously  using  the  designated  Time  Step. 
Click  the  Done  button  to  remove  the  Animate  window  (it  will  retain  the  current  settings). 

7)  View  of  the  inner  proton  radiation  belt,  the  outer  electron  radiation  belt,  and  the  auroral  oval 

at  the  DMSP  altitude, 

•  CRRESPRO  -  Scroll  up  the  Available  Modules  list  and  select  Orbit  Slice.  An  OrbitSlice 
object  will  be  added  to  the  Active  Modules  list  and  a  set  of  Orbit  Slice  Options  will  appear. 

•  Use  the  Satellite  selector  to  pick  DMSPF14.  Click  the  Data  button  and  select  Flux  under  the 
SciCrresPro  option.  The  coordinate  parameters  PO,  PI,  andE’2  correspond  to  the  three 
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coordinates  that  are  set  by  the  Grid  Tool  in  the  appropriate  Seienee  Module  (for  this  example 
they  represent  geoeentrie  radius,  latitude,  and  longitude).  Seleet  PO  to  produee  a  shoe  of  flux 
values  at  eonstant  radius.  Seleet  Display  to  plaee  the  orbit  shoe  in  the  aetive  window. 

Cliek  in  the  window  that  does  not  have  proton  data  showing,  and  eliek  Display  onee  more  to 
plaee  the  eoordinate  sliee  in  the  other  window.  At  DMSP  altitude  the  inner  belt  appears  as  a 
relatively  loealized  area  eentered  near  304°  E  longitude  and  -30°  latitude. 

The  transpareney  of  the  CRRESPRO  Orbit  Sliee  ean  be  ehanged  by  elieking  on  the 
Transparency  button  at  the  right  side  of  the  Orbit  Sliee  Options  seetion.  A  Transparency 
slider  will  be  displayed  at  the  bottom  of  the  window.  Changing  the  slider  value  of  0.70  so  the 
continent  outlines  ean  be  seen.  At  this  altitude,  it  should  be  apparent  that  a  maximum  in  flux 
intensity  appears  near  the  east  eoast  of  South  America.  This  feature  is  referred  to  as  the  South 
Atlantie  Anomaly  (SAA). 

CRRESELE  -  Seleet  Orbit  Slice  again  in  the  Available  Modules  list  on  the  left.  Another 
OrbitSlice  objeet  will  be  added  to  the  Active  Modules  list  and  a  set  of  Orbit  Shoe  options  will 
appear.  Use  the  Satellite  seleetor  to  pick  DMSPF14.  Click  the  Data  button  and  seleet  Flux 
under  the  SciCrresEle  option.  Seleet  PO  to  produee  a  sliee  of  flux  values  at  eonstant  radius. 
Seleet  Display  to  plaee  the  orbit  shoe  in  the  aetive  window.  Cliek  in  the  window  that  does  not 
have  eleetron  data  showing,  and  eliek  Display  onee  more  to  plaee  the  eoordinate  sliee  in  the 
other  window.  Use  the  Transparency  feature  to  set  a  Transpareney  value  of  0.70. 

AURORA  -  Select  Orbit  Slice  again  in  the  Available  Modules  list  on  the  left.  Another 
OrbitSlice  object  will  be  added  to  the  Active  Modules  list  and  a  set  of  Orbit  Shoe  Options 
will  appear.  Use  the  Satellite  seleetor  to  piek  DMSPF14.  Cliek  the  Data  button  and  seleet  Ion 
Number  Flux  under  the  SciAurora  option.  Seleet  PO  to  produee  a  sliee  of  flux  values  at 
constant  radius.  Select  Display  to  place  the  orbit  shoe  in  the  active  window.  Click  in  the 
window  that  does  not  have  aurora  data  showing,  and  eliek  Display  onee  more  to  place  the 
eoordinate  sliee  in  the  other  window.  Use  the  Transparency  feature  to  set  a  Transparency 
value  of  0.70.  With  the  2D  window  aetive,  uneheek  the  Show  Color  Bar  option  listed  in  the 
Viewport  menu  and  the  2D  graphie  window  should  resemble  the  following  figure. 
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8)  Create  constant  longitude  3D  views  of  the  inner  proton  radiation  belt  and  the  outer  electron 

radiation  belt, 

•  Scroll  up  the  Available  Modules  list  and  click  on  Coord  Slice.  A  Coord  Slice  Object  will  be 
added  to  the  Active  Modules  list  and  a  set  of  Coord  Slice  Options  will  appear. 

•  Click  the  Data  button  and  select  Flux  under  the  SciCrresPro  option.  Under  Cut  Plane,  select 
the  C2  option.  Click  in  the  3D  window  to  make  it  active  and  select  Display  to  place  a 
coordinate  slice  at  a  constant  longitude  in  the  3D  window.  You  may  need  to  use  the  left 
mouse  button  to  rotate  the  Earth  to  see  the  coordinate  slice. 

•  Return  to  Available  Modules  and  click  on  Coord  Slice.  A  second  Coord  Slice  Object  will  be 
added  to  the  Active  Modules  list  and  a  new  set  of  Coord  Slice  Options  will  appear. 

•  Click  the  Data  button  and  select  the  Flux  under  the  SciCrresEle  option.  Under  Cut  Plane 
select  the  C2  option  and  click  Display  to  place  cross-section  of  the  outer  electron  belt  from 
the  CRRESELE  model  in  the  3D  Window. 

•  Repeat  the  first  4  steps  in  this  Section  8  to  generate  a  second  cross-section  of  the  inner  proton 
and  outer  electron  belts.  In  each  of  these  two  new  cross-sections,  move  the  Position  Value 
slider  under  Coord  Slice  Options  to  -0.5  so  that  the  longitude  slice  is  diametrically  opposed 
(at  180°)  to  the  two  original  cross-sections. 

•  The  image  in  the  3D  Window  can  be  rotated/scaled  by  using  the  left/right  mouse  button 
when  the  pointer  is  in  the  3D  Window.  Use  the  mouse  controls  to  arrange  the  Earth  in  the  3D 
Window  so  it  resembles  the  following  figure. 


•  Scroll  down  the  Available  Modules  list  and  select  Isocontour  and  an  Isocontour  object  will 
be  added  to  the  Active  Modules  list  and  a  set  of  Isocontour  options  will  appear. 

•  Use  the  Data  button  to  select  SciCrresPro  and  the  Flux  option.  Click  Display  and  a  green 
Isocontour  will  appear  representing  the  proton  belt.  Move  the  Contour  Value  slider  to  a  value 
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of  0.75  and  use  Transparency  and  set  the  Transparency  slider  to  0.70.  A  view  from  the 
higher  northern  latitudes  should  resemble  the  following  figure. 


9)  A  one-dimensional  plot  of  the  CRRESPRO  proton  flux,  CRRESELE  eleetron  flux,  and 
AURORA  ion  number  flux  as  seen  by  the  DMSP  satellite  ean  be  generated  as  follows, 

•  Return  to  the  Window  menu  of  the  Environment  Window  and  seleet  Create  ID  Viewport.  An 
empty  ID  Window  with  a  white  lined  frame  will  appear  and  fill  the  graphies  window  area. 
This  new  ID  menu  is  represented  by  the  new  3:3  entry  in  the  Window  menu. 

•  Seroll  down  the  Available  Modules  list  and  seleet  Orbit  Probe.  An  Orbit  Probe  Object  will 
be  added  to  the  Active  Modules  list  and  a  set  of  Orbit  Probe  Options  will  appear. 

•  Click  on  the  Path/Abscissa  button  and  select  the  Time  option  under  AppSatel  (this  represents 
the  DMSP  F14  satellite.  Click  on  the  Data/Ordinate  button  and  select  the  Flux  option  under 
SciCrresPro.  Click  on  Display  and  a  Flux  vs.  Time  along  the  DMSP  orbit  will  appear. 

•  Repeat  the  last  2  steps,  replacing  SciCrresEle  for  SciCrresPro.  Now,  repeat  those  same  2 
steps  once  again  but  select  Ion  Number  Flux  under  SciAurora  instead  of  Flux  under 
SciCrresPro. 

•  Since  the  time  scale  (x-axis)  is  the  same  for  all  flux  curves,  two  of  the  three  may  be  deleted 
to  avoid  redundancy.  To  do  this,  uncheck  the  Enabled  option  in  the  X  Axis  section.  Now 
highlight  a  different  Orbit  Probe  object  under  the  Active  Modules  list  (not  the  Available 
Modules  list!).  Repeat  the  above  procedure  to  delete  a  second  x-axis.  The  ID  Window  should 
resemble  the  final  figure  below. 

This  ID  figure  and  the  2D  figure  produced  earlier  illustrate  how  DMSP  can  be  exposed,  in  turn, 
to  auroral  (green),  proton  belt  (white),  and  electron  belt  (red)  fluxes.  Select  Animate  Tool  from 
the  Edit  menu  and  start  the  Animation.  If  you  view  the  1-D  (follow  the  colored  dots  showing  the 
current  flux)  and  2-D  (follow  the  satellite  marker)  plots  together  you  can  see  the  correspondence 
between  them. 
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This  completes  the  Example  of  the  Low  Earth  Orbit  Particle  Environment. 
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3)  The  Earth’s  Magnetic  Field:  Placement  of  the  Current  Sheet  (Dynamic) 

The  following  dynamic  example  demonstrates  the  use  of  the  magnetic  field  BFIELD-APP 

Module,  the  COORDSLICE  and  EIEED-EINES  Graphics  Module,  Animation,  and  a  variety  of 

other  visualization  tools. 

Goal:  The  solar  wind  interacts  with  the  Earth’s  intrinsic  magnetic  field  to  form  a  magnetic 
cavity  called  the  magnetosphere.  Solar  wind  pressure  (from  particles  and  magnetic 
field)  compresses  the  magnetosphere  on  the  dayside  and  helps  to  form  an  extended 
magnetotail  of  several  hundred  Earth  radii  in  length  on  the  nightside.  The  overall 
interaction  results  in  a  sheet  of  westward  traveling  current  on  the  nightside  that 
separates  a  region  of  anti-sunward  directed  field  lines  from  a  region  of  sunward 
directed  field  lines,  i.e.,  magnetic  field  lines  emanate  from  the  south  pole  and  extend 
down  the  magnetotail  before  passing  up  through  the  cross-tail  current  sheet  and 
returning  to  Earth  to  connect  at  the  north  pole.  In  addition,  the  placement  of  the  cross¬ 
tail  current  sheet  (where  the  magnetic  field  lines  change  polarity)  changes  as  a 
function  of  Earth’s  dipole  tilt  angle  relative  to  the  solar  direction.  The  goal  of  this 
example  is  to  examine  the  motion  of  the  current  sheet  and  the  magnetic  field  lines 
near  the  midnight  meridian  during  a  period  when  the  dipole  tilt  angle  is  large. 

Start  a  dynamic  AE-GEOSpace  session  and  set  global  input  parameters, 

•  Initiate  AE-GEOSpace  via  the  Start  menu  {Start>Progmms>AFGeospace>AFGeospace), 
the  desktop  icon,  or  by  double-clicking  on  the  file  $AEGS_HOME\bin\AEGeospace.bat. 
Maximize  the  AE-GEOSpace  user  interface  window.  The  shell  windows  can  be  minimized 
but  must  remain  open  for  AE-GEOSpace  to  function. 

•  Establish  a  dynamic  session  by  placing  a  check  mark  in  the  small  box  to  the  right  of  the 
Start:  UT  text  field  to  activate  the  End:  Year,  Day,  UT  text  fields.  Eor  this  example,  we  will 
select  a  time  period  with  large  dipole  tilt  angles.  Edit  the  Start  text  fields  so  that  Year  =  1989, 
Day  =  160,  and  UT=  03:00.  Edit  the  End  text  fields  so  that  Year  =  1989,  Day  =161,  and  UT 
=  03:00.  Erom  the  Globals:  selector  options  (on  the  same  bar  as  the  time  inputs)  pick  Archive 
to  automatically  load  parameters  from  the  NGDC  archive.  Note  that  the  only  global 
parameters  affecting  the  magnetic  field  configurations  are  the  Day,  LIT,  and  Kp. 

•  View  the  global  parameters  for  the  interval  selected  using  the  Globals  menu  (between  the 
Viewport  and  Help  menus  at  the  very  top  of  the  environment  window)  and  selecting  the  Show 
option.  Scroll  down  the  Globals  text  window  that  appears  and  notice  that  the  geomagnetic 
activity  index  Kp  ranges  from  2.3  to  5.7  during  the  interval  selected.  Dismiss  the  Globals  text 
window  using  the  Save  or  Cancel  buttons  at  the  bottom. 

Display  the  Earth,  Solar  Magnetic  Axes,  Sun  Vector, 

•  Select  the  Graphics  option  in  the  Modules  menu  and  Available  Modules  and  Active  Modules 
lists  will  appear.  Scroll  down  the  Available  Modules  list  and  select  Earth  and  an  Earth  object 
will  be  added  to  the  Active  Modules  list  and  a  set  of  Earth  Options  will  appear  in  the  bottom 
of  the  Environment  Window. 
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•  Under  Outline  Detail  seleet  the  Textured  and  Geographic  Bndys  options.  Under  Grid  Options 
seleet  the  Lat/Lon  Grid  option.  Cliek  in  the  Display  box  to  plaee  the  Earth  in  the  default  3D 
window.  The  left  and  right  mouse  buttons  ean  be  used  to  rotate  and  seale  the  Earth  image 
while  the  cursor  is  in  the  Window. 

•  Select  Axes  from  the  Available  Modules  list  and  an  Axes  object  will  be  added  to  the  Active 
Modules  list.  Change  the  Axes  Erame  selection  from  the  default  GEOC  to  SM  and  also  select 
the  Sun  Vector  option.  The  Solar  Magnetic  (SM)  coordinate  system  is  useful  because  the 
Earth’s  magnetic  dipole  is  aligned  with  the  SM  z-axis  (see  the  Grid  Tool  section  of  the 
documentation  for  coordinate  system  definitions)  and  we  would  like  to  view  the  magnetic 
field  on  the  nightside.  Click  the  Display  box  and  a  set  of  orthogonal  axes  in  the  SM 
coordinate  system  (red,  green,  blue)  will  appear.  Notice  that  the  North  magnetic  pole  (blue 
axis)  is  located  about  1 1  degrees  from  the  geographic  North  Pole  near  Greenland.  The  yellow 
axis  is  the  sun  vector. 

•  Erom  the  Viewport  menu,  remove  the  check  mark  next  to  the  Show  Color  Bar  option. 

Display  a  Time/Date  Eabel  and  Animate  in  the  GSM  View  Position, 

•  Prom  the  Viewport  menu,  select  View  Position  and  then  the  GSM  option.  This  will  keep  the 
3-D  graphics  window  fixed  in  the  GSM  frame  during  animation,  i.e.,  the  Earth  will  rotate  and 
the  sun  vector  will  remain  fixed.  Prom  the  Viewport  menu,  remove  the  check  mark  from  the 
Perspective  setting.  Use  the  left  mouse  button  to  orient  the  Earth  such  that  the  sun  vector 
(yellow)  points  to  the  left  and  the  SM  y-axis  (green)  points  directly  out  of  the  screen. 

•  To  display  a  time  label  in  the  graphics  window,  select  Annotation  from  the  top  of  the 
Available  Modules  list  and  an  Annotation  object  will  be  added  to  the  Active  Modules  list.  A 
set  of  Annotation  Options  will  appear  in  the  Environment  Window.  Place  a  check  mark  in  the 
Show  Date  box  and  click  Display  and  a  time/date  label  will  appear  in  the  far  lower  left  comer 
of  the  graphic  window.  Move  X Position  and  Y  Position  sliders  to  a  value  of 
approximately  0.04  to  make  them  easier  to  read. 

•  To  view  the  rotation  of  the  Earth  and  motion  of  the  SM  coordinate  axes,  select  the  Animate 
Tool  option  in  the  Edit  menu  and  an  Animate  window  will  appear.  Reset  the  Time  Step  (sec) 
text  field  to  match  the  dynamic  step  we  plan  to  use,  i.e.,  10800  seconds,  and  click  the  Update 
button.  Click  the  right  arrow  on  the  time  slider  to  advance  time  at  10800-second  steps  and  the 
3-D  graphic  will  update  automatically.  Notice  that  the  sun  vector  (yellow)  and  SM  y-axis 
remain  fixed  in  the  GSM  view  position  while  the  SM  x-axis  (red)  remains  below  the  sun 
vector  for  the  entire  day.  Set  the  time  slider  to  15:00  06/09/1989  using  the  slider  arrows.  The 
graphic  should  resemble  the  following  figure.  Click  the  Done  button  to  close  the  Animate 
window. 
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Generate  Magnetic  Field  Data, 

•  Choose  Module  from  the  Menu  Bar  and  select  Applications  from  the  options.  Available 
Modules  and  Active  Modules  lists  will  appear.  Select  BFIELD-APP  from  the  Available 
Modules  list.  A  BFIELD-APP  object  will  appear  in  the  Active  Modules  list  and  options  for  B- 
Field  Application  Parameters  will  appear  in  the  Environment  Window. 

•  Under  Generate  select  the  Gridded  Data  and  MLT  Field  Lines  options  and  remove  the  check 
mark  from  Field  Line.  Leave  the  Internal  B-Eield  option  set  as  Centered  Dipole  and 
pick  the  External  B-Eield  option  Tsyganenko  ‘89.  When  the  Tsyganenko  ‘89  Window 
appears  leave  the  Kp  Only  option  selected  and  close  the  window  using  the  OK  button. 

•  To  view  field  lines  in  or  near  a  meridian  they  must  originate  from  a  constant  Magnetic  Local 
Time  (MLT).  Set  the  MLT  Lield  Line  Inputs  to  MLT=Q,  MLAT0=65,  MLAT1=%5,  and 
Steps=\Q.  With  these  settings,  field  lines  from  local  midnight  will  be  separated  by  2-degree 
increments  between  65  and  85  degrees  latitude. 

•  The  near-Earth  portion  of  the  magnetic  field  resembles  a  dipole  field  centered  about  the  Solar 
Magnetic  (SM)  z-axis.  On  the  nightside  of  the  magnetosphere,  the  geomagnetic  tail  aligns 
itself  along  the  Earth-Sun  direction,  i.e.,  with  the  sun  vector.  To  track  the  motion  of  the 
magnetic  field  minimum  (the  approximate  location  of  the  cross-tail  current  sheet)  we  will 
calculate  field  quantities  in  SM  coordinates.  To  set  up  a  3D  grid  in  this  coordinate  system, 
select  the  Grid  Tool  option  in  the  Edit  menu.  At  the  top  of  the  Grid  Tool  window  that 
appears,  select  Spacing  =  Linear,  Geometry  =  Cartesian  and  System  =  SM  and  the 
coordinates  listed  will  change  to  X,  Y,  and  Z,  SM  (Re).  To  form  a  grid  box  on  the  nightside 
of  the  Earth:  (1)  set  X,  SM  (Re)  NPoint=20,  Min=  -30,  and  Max=  -10,  (2)  set  Y,  SM  (Re) 
NPoints=\0,  Min=  -5,  and  Max=5,  and  (3)  set  Z,  SM  (Re)  NPoints=20,  Min=  -10,  and 
Max=10.  Click  the  OX  button  to  close  the  Grid  Tool  Window. 
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•  Select  the  Dynamic  Tool  option  in  the  Edit  menu  and  a  Dynamic  Tool  option  window  will 
appear.  Place  a  check  mark  in  the  boxes  next  to  the  Variables  Bx,  By,  Bz,  \B\,  and  MLT Lines 
noted  at  the  top.  Edit  the  Time  Step  (sec)  text  field  to  read  10800  seconds  and  click  the 
Update  List  button.  These  settings  indicate  which  available  BFIELD-APP  output  variables 
will  be  calculated  during  the  Start/End  period  at  intervals  of  3  hours  (10800  sec).  Click  the 
Done  button  to  register  your  selections  and  dismiss  the  Dynamic  Tool  window. 

•  Select  the  Run/Update  option  in  the  Edit  menu  to  start  the  calculation  of  the  MET  field  line 
traces  and  the  gridded  data  set.  A  Process  View  window  appears  briefly.  When  complete,  the 
Model  Status  box  lists  the  dipole  tilt  angles  and  the  Kp  used. 

Display  Dynamic  Sequence  of  Magnetic  Field  Fines  in  3-D, 

•  Choose  Module  from  the  Menu  Bar  and  select  Graphics  from  the  options.  Available  Modules 
and  Active  Modules  lists  will  appear.  To  display  magnetic  field  lines,  select  Field  Lines  from 
the  Available  Modules  list.  A  Fieldlines  object  appears  in  the  Active  Modules  list  and  a  set  of 
Field-Lines  Options  appears  in  the  Environment  Window. 

•  Click  on  the  Data  button,  go  down  to  AppBfield  and  choose  Field  Lines-MLT.  Leave  Field 
Lines  selected  as  the  Plot  Type  and  click  Display.  Click  on  the  Color  button  and  click  on  the 
center  of  the  color  wheel  so  that  the  field  lines  become  white. 

•  Use  the  mouse  buttons  while  the  cursor  is  in  the  3D  Window  to  rotate  and  rescale  the  image. 
By  increasing  the  viewing  distance  we  see  that  some  of  the  field  lines  close  in  the  southern 
hemisphere  while  the  higher  latitude  magnetic  lines  are  open  and  extend  well  beyond  our 
view.  Owing  to  model  symmetry,  the  midnight  field  lines  are  coplanar. 

•  Open  the  Animate  window  again  (select  Animate  Tool  from  the  Edit  menu)  and  step  thru 
time  to  see  the  magnetic  field-line  reversal  region  move  up  and  down  in  our  GSM  view 
frame  as  the  dipole  field  (aligned  with  the  blue  axis)  changes  its  orientation  relative  to  the 
solar  vector.  Set  the  time  slider  to  15:00  06/09/1989  using  the  slider  arrows.  The  graphic 
should  resemble  the  following  figure. 
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Display  Dynamic  Sequence  of  Magnetie  Field  Coordinate  Sliees  in  3-D, 

•  To  display  the  magnetie  field  magnitude  values  stored  on  our  SM  grid,  seleet  Coord  Slice 
from  the  Available  Modules  list.  A  Coord  Slice  objeet  appears  in  the  Active  Modules  list  and 
a  set  of  Coordsliee  Options  appear  in  the  Environment  Window. 

•  Cliek  on  the  Data  button  and  ehoose  75/ under  the  AppB field  option  and  eliek  Display. 
Display  the  eolor  bar  by  aetivating  the  Show  Color  Bar  option  in  the  Viewport  menu.  If  the 
eoordinate  sliee  does  not  appear  on  the  nightside  of  the  Earth,  use  the  Animate  Tool  (in  Edit 
menu)  to  get  all  graphies  display  for  the  same  time.  To  get  a  eontour  of  magnetie  field 
strength  in  the  Y-GSM  plane  seleet  Cut  Plane  Cl,  move  the  Position  Value  slider  to  0.500. 


•  View  the  sequenee  using  the  Animate  switeh  in  the  Animate  Window.  Notiee  that  the 

minimum  field  strength  region  (dark  blue)  eorresponds  to  the  magnetie  field  reversal  region. 
This  minimum  field  strength  region  is  also  the  loeation  of  the  eross-tail  eurrent  system  that 
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contributes  to  the  sharp  field  reversal.  In  this  situation,  as  the  North  magnetie  pole  tilts 
toward  the  Sun  the  field  reversal  region  and  current  sheet  move  above  the  GSM  z=  0  plane. 
Set  the  animate  slider  to  12:00  06/09/1989  so  that  the  graphic  resembles  the  upper  figure 
above. 

Display  and  Traek  Geomagnetie  Index  Kp  in  I-D, 

•  Select  Create  ID  Viewport  from  the  Window  menu  and  a  1-D  graphie  window  will  appear 
distinguished  by  white  line  border.  Seleet  the  Tile  option  from  the  Window  menu  to  view 
both  existing  graphie  windows  together.  Plaee  the  mouse  eursor  in  the  1-D  window  and  eliek 
to  aetivate  that  window.  Plaee  the  time/date  label  in  the  1-D  window  by  highlighting  the 
Annotation  entry  in  the  Active  Modules  list  (on  the  right)  and  selecting  Display.  The  label 
will  appear  in  the  lower  left  comer  of  the  1-D  window. 

•  Seroll  down  the  Available  Modules  list  and  seleet  Global  Inputs.  A  Global  Inputs  objeet  will 
be  added  to  the  Active  Modules  list  and  a  set  of  Global  Input  Options  will  appear  in  the 
Environment  Window.  From  the  Value  input  seetion,  seleet  the  Kp  option  and  eliek  Display 
to  produee  a  plot  of  Kp  versus  time.  To  elean  up  this  1-D  plot,  reset  the  Y  Axis  text  fields 
Min  =  0.0  and  Max  =  9.0.  Cliek  the  mouse  in  any  other  text  field  to  update  the  plot.  The  1-D 
plot  should  resemble  the  lower  figure  above.  This  profile  of  the  geomagnetie  index  Kp  was 
used  to  drive  the  Tsyganenko  ‘89  magnetie  field  model. 

•  Use  the  Animate  window  to  view  the  magnetie  field  ehanges  as  the  magnetie  aetivity  index 
Kp  ehanges.  Typieally,  the  geomagnetie  field  beeomes  more  stretehed  on  the  nightside  as  the 
Kp  index  inereases,  i.e.,  the  magnetie  field  lines  beeome  gradually  more  stretehed  after  09:00 
06/09/1989.  Again,  the  field  reversal  region  rises  above  the  GSM  z  =  0  plane  as  the  dipole  tilt 
angle  becomes  more  positive  (blue  axis  points  more  sunward). 

This  eompletes  the  Example  of  The  Earth’s  Magnetie  Field:  Plaeement  of  the  Current  Sheet 
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4)  UHF/L-Band  Scintillation  on  a  Geostationary  Downlink  (V2.5.1  Only) 

The  following  example  demonstrates  the  use  of  the  WBMOD  (WideBand  Model)  Seienee 

Module  and  a  variety  of  other  visualization  tools. 

Goal:  The  WideBand  Model  (WBMOD)  speeifies  seintillation  parameters  between 

loeations  on  the  globe  and  a  satellite  above  100  km  altitude  as  a  funetion  of  signal 
frequeney  and  geomagnetie  aetivity.  Seintillation  is  the  rapid  amplitude  and  phase 
fluetuations  of  signals  passing  through  ionospherie  irregularities.  The  goal  of  this 
example  is  to  determine  where  the  disturbanee  level  of  seintillation  (S4)  of  UHF  (250 
MHz)  and  L-Band  (1500  MHz)  signals  will  be  severe  at  least  10%  of  the  time  for 
ground-based  reeeivers  within  the  footprint  of  a  geostationary  satellite  under 
moderately  aetive  solar/magnetie  eonditions. 

•  Initiate  AF-GEOSpaee  via  the  Start  menu  {Start>Progmms>AFGeospace>AFGeospace), 
the  desktop  ieon,  or  by  double-choking  on  the  fde  $AFGS_HOME\bm\AFGeospace.bat. 
Maximize  the  AE-GEOSpace  user  interface  window.  The  shell  windows  can  be  minimized 
but  must  remain  open  for  AE-GEOSpace  to  function. 

•  Eor  this  static  run,  set  the  Global  Parameters  as  follows:  Start :Year=\990,  Day=260, 
UT=2\:00.  The  Kp  and  SSN (sunspot  number)  corresponding  to  the  specified  date  and  time 
may  now  be  obtained  by  clicking  on  the  Globals:  Archive  option  to  the  right  of  the  time  input 
fields.  The  NGDC  archived  values  of  these  parameters  are  then  automatically  loaded  {Kp=3, 
5'S7V=137,  F10.7  =210.1,  an0Ap=\5).  Note  that  Year,  F10.7  and  Ap  are  not  used  by 
WBMOD.  These  parameters  describe  conditions  following  passage  of  the  solar  terminator  in 
the  Euro-African  longitude  sector  during  moderate  magnetic  and  solar  activity  conducive  to 
the  development  of  scintillation  near  the  magnetic  equator  on  September  17,  1990. 

•  Choose  Modules  from  the  Environment  Window  Menu  Bar  and  select  Science  from  the 
options.  Available  Modules  and  Active  Modules  lists  will  appear. 

•  Scroll  to  the  bottom  of  the  Available  Modules  list  and  click  on  WBMOD.  A  SciWbmod 
object  will  be  added  to  the  Active  Modules  list  and  a  WBMOD  Options  panel  will  appear  in 
the  Environment  Window.  To  model  the  upper  10%  (90th  percentile)  of  250  MHz 
scintillation  observed  on  the  ground  from  a  geostationary  satellite  located  over  the  Atlantic 
Ocean  set  the  WBMOD  options:  Propagation=7-IFay,  In-situ  Vd=Model,  Step=7?cvr,  EP 
Boundavy=Use  Kp,  Output=Percentile,  Trans.  Freq  (MHz)=250,  Trans.  Alt.  (km)=36000. 
Fixed  End  Lat=0,  Fixed  End  Lon=  -15,  Phase  Stability (s)=\0,  Percentile=0.9,  and 
Kp@LocalSunset=  -1.  All  other  input  parameters  remain  inactive. 

•  Select  the  Run/Update  option  in  the  Edit  menu.  The  Model  Status  box  will.  When  the  run  is 
complete  the  Process  View  Window  will  disappear  and  the  Model  Status  box  will  be  updated 
with  the  text  “MODEL  IS  READY  AND  UP  TO  DATE”  and  the  Global  Parameters  used  to 
construct  the  model  run. 
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Plot  UHF  WBMOD  Results  in  2D, 


•  Return  to  the  Menu  Bar  at  the  top  of  the  Environment  Window,  click  on  Modules  and  select 
Graphics.  Available  Modules  2Lnd  Active  Modules  lists  will  appear.  Scroll  down  and  select 
Earth  from  the  Available  Modules  list.  An  Earth  object  will  be  added  to  the  Active  Modules 
list  and  an  Earth  Options  panel  will  appear  in  the  bottom  of  the  Environment  Window.  Select 
Textured  and  Geographic  Bndys  under  Outline  Detail.  Select  Terminator  under  Grid  Options. 
Click  in  the  Display  box  in  the  Environment  Window  and  the  Earth  will  be  displayed  in  the 
3D  Window;  a  purple  line  shows  the  location  of  the  solar  terminator  at  the  surface. 

•  Change  the  3D  projection  of  Earth  to  a  2D  projection  by  using  the  Viewport  menu  to  select 
Projection  and  then  Two  D.  The  default  3D  window  should  now  have  been  converted  to  a  2D 
window  with  an  Earth  map. 

•  Select  Coord  Slice  from  the  Available  Modules  list.  A  Coord  Slice  object  will  be  added  to  the 
Active  Modules  list  and  a  corresponding  options  panel  will  appear  in  the  bottom  of  the 
Environment  Window.  Under  Coord  Slice  Options  click  on  the  Data  button,  slide  down  the 
popup  menu  to  the  SciWbmod  option,  and  select  S4.  Click  in  the  Display  box  to  display  the 
scintillation  results  on  the  2-D  map. 

•  Select  the  Transparency  button  in  the  Coord  Slice  Options  panel.  Increase  the  transparency 
of  the  S4  plot  by  moving  the  Transparency  slider  to  a  value  of  0.7  and  uncheck  the  Lighting 
option.  Select  the  Data  Map  option  and  set  Data  Min  =  0.0.  The  plot  should  resemble  the 
following  figure. 


Create  WBMOD  Model  Output  for  L-band  (1.5  GHz), 

•  Click  on  Module  menu  and  select  Science  and  Available  Modules  and  Active  Modules  lists 
will  appear.  Scroll  down  the  Available  Modules  list  on  the  left  and  select  WBMOD  again  and 
a  second  SciWbmod  entry  appears  in  the  Active  Modules  list  on  the  right.  The  WBMOD 
Options  panel  will  appear  in  the  bottom  of  the  Environment  Window. 
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To  model  the  upper  10%  (90th  percentile)  of  1500  MHz  scintillation  observed  on  the  ground 
from  a  geostationary  satellite  located  at  the  equator  over  the  Atlantic  Ocean  set  the  following 
WBMOD  options:  Propagation=i-lFa>',  Step=i?cvr,  Oui^ut=P ercentile,  Trans.  Freq 
(M//z)=1500,  Trans.  Alt.  (K'm)=36000,  Fixed  EndLon=  -15,  Percentde=0.9,  and 
Kp@LocalSunset=  -1.  All  other  WBMOD  parameters  may  be  left  at  the  default  values.  These 
inputs  are  the  same  as  those  entered  to  get  the  existing  2D  plot  except  for  the  increase  in 
Trans.  Freq  (MHz).  Note  that  the  Global  Parameters  at  the  top  of  the  Environment  Window 
set  earlier  do  not  change. 

Select  the  Run/Update  option  in  the  Edit  menu  and  after  the  View  Process  Window  has 
disappeared  and  the  Model  Status  box  has  been  updated,  there  is  a  second  WBMOD  data  set 
available  for  display. 

Return  to  the  Menu  Bar  at  the  top  of  the  Environment  Window,  click  on  Window  and  select 
Create  2D  Viewport.  A  second  2D  Window  will  appear.  Click  on  the  Window  menu  again 
and  select  Tile.  The  graphic  area  should  now  be  shared  by  the  2D  windows. 

Return  to  the  Menu  Bar  at  the  top  of  the  Environment  Window,  click  on  Module  and  select 
Graphics.  Available  Modules  and  Active  Modules  lists  will  appear.  The  Active  Modules  list 
will  already  contain  Earth  and  Coord  Slice  objects  from  the  UHE  results  plot.  Select  Earth 
from  the  Active  Modules  list  on  the  right,  click  in  the  empty  graphics  window  to  activate  it, 
and  check  the  Display  box.  This  procedure  simply  places  a  copy  of  the  Earth  with  terminator 
in  the  new  window. 

Select  Coord  Slice  from  the  Available  Modules  list  on  the  left.  A  second  Coord  Slice  object 
will  be  added  to  the  Active  Modules  list  and  a  set  of  Coord  Slice  Options  will  appear  in  the 
bottom  of  the  Environment  Window.  Under  Coord  Slice  Options  click  on  the  Data  button, 
slide  down  the  popup  menu  to  the  second  SciWbmod  option,  and  select  S4.  Click  in  the 
Display  box  to  display  the  scintillation  results  on  the  new  two-dimensional  map.  To 
reproduce  the  final  figure,  click  on  the  Transparency  button  and  set  the  slider  value  to  0.7 
and  then  uncheck  the  Lighting  option. 
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Interpretation  of  Results:  The  results  indieate  that  the  90th  pereentile  of  S4  index  at  250  MHz 
within  20  degrees  of  the  magnetic  equator  over  most  of  Africa  at  21:00  UT  will  be  unity,  i.e., 
severely  scintillated  at  least  10%  of  the  time  (i.e.,  1  out  of  10  days)  for  the  geophysical 
conditions  specified  (see  first  plot  made).  Recall,  for  the  step-receiver  mode,  the  data  will  be 
plotted  at  the  receiver  location,  not  at  the  ionospheric  location  where  scintillation  occurred. 
Similarly,  in  the  step -transmitter  mode,  data  is  for  scintillation  on  the  ray-path  from  the  satellite 
to  the  receiver  and  plotted  at  the  sub-satellite  point.  This  display  location  would  not  be  the 
ionospheric  location  where  the  scintillation  occurred.  As  expected,  the  level  of  scintillation 
experienced  by  L-band  (1.5  GHz)  signals  is  substantially  lower  over  most  of  the  affected  region 
(see  second  plot).  The  95th  percentile  fade  (dB)  can  be  displayed  by  returning  to  the  Coord  Slice 
Options  panel  (select  Graphics  under  the  Module  menu,  click  on  the  second  Coord  Slice  in  the 
Active  Modules  list)  and  selecting  95%tile  FADE  from  the  second  of  the  WBMOD  Data  options. 
Both  UHF  and  L-band  results  may  be  obtained  in  this  manner  by  selecting  the  Coord  Slice  entry 
that  corresponds  to  each  frequency.  Do  not  confuse  this  percentile  with  the  climatological 
percentile  input  to  run  WBMOD.  For  example,  we  selected  a  90*  percentile  climatology  for  this 
example.  This  display  represents  the  5th  most  severe  fade  on  the  10th  most  disturbed  day.  Recall, 
that  scintillation  is  the  rapid  fluctuation  of  the  signal’s  amplitude  and  phase.  Therefore,  if  any  of 
the  fades  are  below  the  receiver’s  fade-margin  even  for  small  amounts  of  time,  this  may  be 
enough  to  cause  communication  problems,  especially  if  the  message  is  encrypted. 

This  completes  the  Example  of  UHF/L-Band  Scintillation  on  a  Geostationary  Downlink. 
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5)  HF  Ray-Tracing  in  the  Ionosphere 

The  following  example  demonstrates  the  use  of  the  Parameterized  lonospherie  Model  (PIM) 

Seienee  Module,  the  2-D  ray-traeing  Applieation  Module,  and  a  variety  of  visualization  tools. 

Goal:  Eleetron  density  variations  in  the  ionosphere  determine  how  radio  eommunieations 
signals  propagate.  Signals  tend  to  bounee  off  regions  where  the  loeal  eritieal  plasma 
frequeney  is  greater  than  the  signal  frequeney  (high  eleetron  density  eorrelates  with 
high  eritieal  plasma  frequeney).  Therefore,  an  HF  signal  transmitted  from  a  ground 
station  with  just  the  right  frequeney  ean  experienee  multiple  “hops”  and  be  reeeived 
at  several  geographie  loeations  along  its  ray  path.  The  goal  of  this  example  is  to 
generate  ionospherie  data  sets,  ineluding  3D  eleetron  density  profdes  and  a  2D  map 
of  eritieal  frequeneies  in  the  F2  layer  (ealled  foF2),  and  examine  how  HF  rays 
propagating  from  ground-based  transmitters  follow  frequeney  dependent  paths,  i.e., 
travel  different  distanees  before  returning  to  the  Earth’s  surfaee. 

•  Initiate  AF-GEOSpaee  via  the  Start  menu  {Start>Programs>AFGeospace>AFGeospace), 
the  desktop  ieon,  or  by  double-elieking  on  the  file  $AFGS_HOME\bin\AFGeospaee.bat. 
Maximize  the  AF-GEOSpaee  user  interfaee  window.  The  shell  windows  ean  be  minimized 
but  must  remain  open  for  AF-GEOSpaee  to  funetion. 

•  For  this  statie  run,  set  the  Global  Parameters  as  follows:  Start :Year=\99\,  Day=187, 
f/7'=00:00.  Cliek  on  the  Archive  option  of  the  Globals  button  and  the  Kp,  SSN  (sunspot 
number),  F10.7  radio  flux,  and  Ap  index  eorresponding  to  the  speeified  date  and  time  will  be 
loaded  automatieally  from  arehived  NGDC  values  {Kp=\3,  5'57V=204,  FIO.  7=240.8,  and 
Ap=5). 

Create  a  PIM  Model  data  set, 

•  Choose  Modules  from  the  Menu  Bar  and  seleet  Science  from  the  options.  Available  Modules 
and  Active  Modules  lists  will  appear.  Seroll  down  in  the  Available  Modules  list  and  eliek  on 
PIM.  A  PIM  objeet  will  be  added  to  the  Active  Modules  list  on  the  right  and  a  set  of  PIM 
Options  will  appear  in  the  Environment  Window. 

•  Cliek  on  the  IMF  By  menu  button  and  seleet  Positive.  Feave  the  other  options  at  their  default 
values.  These  settings  will  run  PIM  with  no  normalization  under  eonditions  with  a  positive 
Interplanetary  Magnetie  Field  (IMF)  By  eomponent  and  negative  Bz  eomponent.  The  default 
grid  is  set  to  2°  latitude  x  5°  longitude,  the  resolution  most  eompatible  with  the  ray-traeing 
program.  The  PIM  model  results  are  written  to  the  default  output  file  named  “pim_pud.out”. 

•  Seleet  the  Run/Update  option  in  the  Edit  menu.  When  the  Process  View  Window  disappears 
the  Model  Status  box  will  indieates  the  Global  Parameters  used. 

Plot  the  PIM  eritieal  frequeney  profile  in  the  F2  layer  (ealled  foF2), 

•  At  the  top  of  the  Environment  Window,  eliek  on  Module  and  seleet  Graphics.  Available 
Modules  and  Active  Modules  lists  will  appear.  Seleet  Earth  from  the  Available  Modules  list. 
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An  Earth  object  will  be  added  to  the  Active  Modules  list  and  an  Earth  Options  panel  will 
appear  in  the  bottom  of  the  Environment  Window.  Click  in  the  Display  box  in  the 
Environment  Window  and  the  Earth  will  be  displayed  in  the  3D  Window. 

•  Select  Coord  Slice  from  the  Available  Modules  list.  A  Coord  Slice  object  will  be  added  to  the 
Active  Modules  list  and  a  corresponding  options  panel  will  appear  in  the  bottom  of  the 
Environment  Window.  Use  the  Data  button  to  select  the  FoF2  option  under  SciPim,  click  the 
Display  box  to  place  the  EoE2  coordinate  slice  in  the  3D  window.  Next  select  Transparency 
and  adjust  the  slider  that  appears  at  the  bottom  of  the  window  to  a  value  of  0.75. 


SciPimO 

PIM 

I - r15.75 


8.565 


4.972 


I - ‘1.380 

FoF2 

MHz 


80:00  07/06/1991 


•  Select  Annotation  from  the  Available  Modules  list  and  an  Annotation  object  will  be  added  to 
the  Active  Modules  list  and  Annotation  Options  will  appear.  Place  a  check  mark  in  the  Show 
Date  box  and  click  Display.  A  time/date  label  appears  in  the  lower  left  corner  of  the  graphic 
window.  Reset  ihs  X Position  and  Y Position  sliders  to  0.04  to  make  the  label  easier  to  read. 

•  Highlight  the  Coord  Slice  entry  in  the  Active  Modules  list  on  the  right  and  the  EoE2  color  bar 
will  reappear  in  the  graphic  window.  Use  the  left  and  right  mouse  buttons  to  rotate  and 
rescale,  respectively,  the  view  until  it  resembles  the  figure  above. 

Plot  HE  Ray-Traces, 

•  At  the  top  of  the  Environment  Window,  click  on  Module  and  select  Applications.  Available 
Modules  and  Active  Modules  lists  will  appear.  Scroll  down  the  Available  Modules  list  and 
select  RAYTRACE-APP.  Pea  AppRayTrace  entry  will  appear  in  the  Active  Modules  list  and  a 
selection  of  Ray  Tracing  Application  options  will  appear. 
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•  Leave  the  Model:  Australian  2D  selection.  In  the  Freq  (MHz)  input  section  pick  Multi  and 
set  the  Freq(MHZ)  parameters  to  go  From  16  To  26  with  a  Step  of  5.0.  In  the  Elev  (deg) 
section  select  Single  and  set  the  Single  value  to  10  degrees.  Leave  the  Azimuth,  Range(1000 
km),  and  Max  Flops  settings  at  their  default  values.  Adjust  the  Transmitter  Location  settings 
to  reflect  Bangor  Maine  as  the  location,  i.e.,  set  Lat  =  44.8  degrees  and  Lon  =  -68.8  degrees. 

•  To  perform  the  ray  traces  through  the  PIM  ionosphere  just  calculated,  click  on  the  Open  Pirn 
File  button  and  open  the  file  “pim_pud.out”  found  in  the  SciPim  folder  newly  created  in  the 
Scratch  Directory. 

•  To  trace  the  selected  rays,  select  the  Run/Update  option  in  the  Edit  menu.  The  View  Process 
Window  will  vanish  when  the  ray  tracing  is  complete. 

•  Click  on  the  Display  Plot  button  and  a  2D  plot  will  fill  the  graphics  display  window.  Now 
click  on  the  Plot  Options  button  to  adjust  this  ray  trace  plot.  In  the  Ray  Plot  Options  window, 
click  on  the  Captions  button  and  the  Plasma  Frequency  button.  Move  the  Plasma  Frequency 
slider  to  0.90  MHz  and  click  OK.  The  plot  should  now  look  like  the  following  figure. 

•  The  same  set  of  ray  trace  can  be  viewed  in  a  3D  window  by  using  the  RayTrace  graphic  and 
choosing  the  only  Data  button  option  available. 


This  completes  the  Example  of  HE  Ray-Tracing  in  the  Ionosphere. 
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6)  The  Energetic  Solar  Event  of  20  February  1994  (V2.5.1  Only) 

The  following  example  demonstrates  the  use  of  the  Interplanetary  Shoek  Propagation  Model 

(ISPM),  Shoek  Time  of  Arrival  (STOA),  and  Proton  Predietion  System  (PPS)  Seienee  Modules. 

Goal:  High-speed  interplanetary  shoeks  originate  near  the  Sun’s  surfaee  and  propagate  out 
into  the  solar  system  to  disrupt  the  eharaeter  of  the  nominally  steady  solar  wind. 

Large  shoeks  that  hit  the  Earth’s  magnetosphere  ean  drastieally  ehange  the  near-earth 
partiele  and  eleetrie  and  magnetie  field  environment  and  affeet  the  operation  of  man¬ 
made  systems.  Energetie  protons,  also  originating  with  solar  disturbanees,  arrive  on 
mueh  shorter  time  seales  and  ean  penetrate  deep  into  the  near-earth  environment  and 
adversely  affeet  both  instruments  and  biologieal  systems.  The  goal  of  this  example  is 
to  investigate  the  foreeasting  eapabilities  of  ISPM,  STOA,  and  PPS  using 
observations  of  the  energetie  solar  event  of  20  Eeb  94  and  subsequent  terrestrial 
effeets.  The  energetie  solar  event  involved  a  disappearing  filament  and  an  M4/3B 
flare  at  0104UT  on  20  Eeb  94.  This  event  was  responsible  for  enhaneed  levels  of 
energetie  protons  observed  by  the  GOES  satellite  at  geosynehronous  orbit  and  is 
believed  to  have  eaused  a  CME/shoek  that  arrived  at  the  Earth  the  next  day.  All  input 
data  were  taken  from  the  NOAA  Solar-Geophysieal  Data  Preliminary,  Prompt,  and 
Comprehensive  Reports. 

•  Initiate  AE-GEOSpaee  via  the  Start  menu  {Start>Progmms>AFGeospace>AFGeospace), 
the  desktop  ieon,  or  by  double-elieking  on  the  file  $APGS_HOME\bin\APGeospaee.bat. 
Maximize  the  AE-GEOSpaee  user  interfaee  window.  The  shell  windows  ean  be  minimized 
but  must  remain  open  for  AE-GEOSpaee  to  funetion. 

•  Eor  this  statie  run,  set  the  global  time  parameters  to  mateh  the  observed  solar  flare  time,  i.e., 
set  Start:Year=\994,  Day=5\,  and  UT=9\:94.  Cliek  on  the  Globals:  Archive  seleetion  to  the 
right  of  the  time  inputs  to  automatieally  load  the  appropriate  parameters  from  the  NGDC 
arehive  {Kp=4.1,  S'57V=16,  FIO.  7=105.2,  and  Ap=39).  None  of  these  global  parameters  are 
used  as  inputs  for  this  example. 

Run  the  ISPM  and  display  text  results, 

•  Prom  the  Modules  menu  at  the  top  of  the  Environment  Window,  seleet  the  Science  option. 
Available  Modules  and  Active  Modules  lists  will  appear.  Seroll  down  the  Available  Modules 
list  and  eliek  on  ISPM.  A  Scilspm  objeet  will  be  added  to  the  Active  Modules  list  and  a  set  of 
ISPM  Options  will  appear  in  the  Environment  Window. 

•  Under  Speeify  Event  Duration,  seleet  the  X-ray  Levels  option.  We  will  use  the  GOES  7  1-8 
Angstrom  X-ray  data  to  determine  the  duration  of  the  event.  Eeave  the  Event  in  the  previous 
24  hours?  box  empty  as  there  were  none. 

•  Both  Palehua  and  Eearmonth  RSTN  sites  observed  Type  II  radio  bursts  for  this  event  with 
estimated  shoek  speeds  of  1000  km/s  and  1400  km/s,  respeetively,  starting  at  0I08UT.  An  H- 
alpha  flare  of  magnitude  3B  was  observed  on  the  solar  surfaee  at  N09  and  W02  by 
Eearmonth  at  0138UT  and  lasted  for  90  minutes.  Given  this,  edit  the  Event  onset  time  text 
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box  to  read  “02/20/94  01:08”,  set  F/are  lat  (deg  N)  =9,  and  Flare  Ion  (deg  W)  =2.  Assume 
the  shoek  veloeity  to  be  the  average  of  the  two  observations  and  set  Type  II  speed  (km/s) 
=1200. 


•  Examining  the  GOES  7  X-ray  data  in  the  1-8  Angstrom  band,  the  baekground  elassifieation 
before  the  event  was  approximately  B2.0  and  the  elassifieation  of  the  peak  of  the  event  was 
M4.0.  Enter  Backg.  Class  =B2.0  and  Peak  Class.  =M4.0.  Eurther  examination  of  the  GOES 
data  indieates  that  after  the  peak  of  the  X-ray  event,  the  level  deeayed  to  elass  C2.8  at  about 
0320UT  on  2/20/94.  Edit  the  Event  end  time  text  box  to  read  “02/20/94  03:20”. 


•  Seleet  the  Run/Update  option  in  the  Edit  menu  to  exeeute  ISPM  and  a  text  box  will  appear 
eontaining  the  following  results.  The  Display  Text  button  redisplays  the  text  result. 

-  ISPM  -  Interplanetary  Shock  Propagation  Model  -  Version  1.0  - 

Shock  will  reach  Earth  1994  02  21  1109Z 

Total  propagation  time  34h  01m 

Shock  strength  (jump  in  dynamic  pressure),  6.8  dynes/cm2  x  10-8 

Shock  Strength  Index,  SSI  1. 1 

if  >  0  expect  shock  to  be  sufficiently  strong 
magnitude  of  SSI  reflects  strength  of  shock, 
if  =  0,  then  shock  strength  borderline 
if  <-l,  then  expect  no  effects 


Input  Parameters: 

Type  II  onset  time 
X-ray  event  end  time 
Driver  duration 

Energy  input  by  flare 

Type  II  speed 
Solar  flare  at 


1994  02  20  0108Z 

1994  02  20  0320Z 

2h  12m,  reset  to  2. Oh 

7 . 4  xlO+30  erg 

1200.0  km/s 
N09  W02  deg 


The  ISPM  results  above  show  that  a  shock  will  reach  Earth  at  1 1:09  UT  on  02/21/94  with  a 
dynamic  pressure  jump  of  6.8e-8  dynes/cm^  after  traveling  for  a  period  of  34  Hours  and  01 
minute.  Ground  magnetometer  data  show  that  a  Sudden  Impulse  occurred  at  09:0 lUT  02/21/94 
indicative  of  the  passage  of  a  solar  wind  shock  by  the  Earth.  This  is  confirmed  by  solar  wind  data 
from  the  1MP8  spacecraft  showing  a  shock  passage  with  a  dynamic  pressure  jump  of  about  1 .6e- 
7  dynes/cm7  In  this  case  ISPM  predicted  the  shock  arrival  two  hours  late  (a  6%  error  in  overall 
propagation  time)  and  a  dynamic  pressure  jump  smaller  than  observed  by  a  factor  of  2.4. 

Run  the  STOA  model  and  display  text  results, 

•  Scroll  down  the  Available  Modules  list  and  click  on  STOA.  A  SciStoa  object  will  be  added  to 
the  Active  Modules  list,  and  a  set  of  STOA  Options  will  appear  in  the  Environment  Window. 
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•  Under  “Specify  Event  Duration”  select  the  X-ray  Levels  option.  We  will  use  the  same  GOES 
7  1-8  Angstrom  X-ray  data  we  used  for  the  ISPM  module.  As  in  the  ISPM  case,  enter  the 
following  data  in  the  appropriate  boxes  so  that  the  STOA  program  can  compute  event 
duration;  Event  onset  time  ~  “02/20/94  01:08”,  Flare  lat  (degN)  =9,  Flare  Ion  (deg  W)  =2, 
Type  II  speed  (km/s)  =  1200,  Back.  Class.  =B2.0  and  Peak  Class.  =M4.0.  Click  in  the  Decay 
time  text  box  (and  label  will  change)  and  edit  the  Decay  time,  level=C2.8  text  box  to  read 
“02/20/94  03:20”. 

•  In  the  STOA  model  we  have  the  option  of  entering  a  solar  wind  speed.  Enter  Solar  wind 
speed  (km/s)  =400  to  match  the  value  used  by  default  in  the  ISPM  case.  It  should  be  noted 
that  the  real  solar  wind  speed  can  be  quite  variable.  On  02/20/94  the  IMP-8  satellite  recorded 
a  solar  wind  speed  that  varied  from  about  580  km/s  at  08:00  to  about  500  km/s  near  the  end 
of  the  day.  Prior  to  08:00  there  was  a  data  gap  on  that  day.  The  next  morning  the  solar  wind 
speed  had  decreased  to  about  400  km/s  by  01:00.  Another  data  gap  ensued  and  then  the  solar 
wind  speed  was  400  km/s  from  about  07:20  until  the  time  of  the  observed  shock  at  09:00. 

•  Select  the  Earth  option  under  Observer  Eocation. 

•  Select  the  Run/Update  option  in  the  Edit  menu  to  execute  STOA  and  a  text  box  will  appear 
containing  the  following  results.  The  Display  Text  button  redisplays  the  text  result. 


STOA  -  Shock  Time  of  Arrival  -  Version  1.0 


Mach  5.4  shock  will 

Total  propagation  time 

reach  Earth 

1994  02  21 
46h  01m 

2309Z 

Type  II  onset  time 
X-ray  event  end  time 
Driver  duration 

1994  02 
1994  02 

2h  12m 

20  0108Z 

20  0320Z 

Type  II  speed 

Solar  flare  at 

Solar  wind  speed 

1200.0 
N09  W02 
400.0 

km/s 

deg 

km/s 

Sun-Earth  distance 

0.9889 

AU 

The  above  STOA  results  show  that  a  Mach  5.4  shock  will  reach  Earth  at  23:09  UT  on  02/21/94, 
after  traveling  for  a  period  of  46  hours  and  01  minute.  This  is  14  hours  and  08  minutes  later  than 
the  observed  shock  described  earlier,  and  exactly  12:00  hours  later  than  the  ISPM  predicted  time. 

Run  PPS  and  display  text  results, 

•  Click  on  PPS  in  the  Available  Modules  list.  A  SciPPS  object  will  be  added  to  the  Active 
Modules  list  and  a  set  of  Proton  Prediction  system  (PPS)  Options  will  appear  in  the 
Environment  Window. 

•  Under  Specify  Data,  select  the  Radio  option  and  under  Specify  Elux  Type,  leave  Peak  Flux 
as  the  default  flux  type.  Also  leave  the  Radio  Frequency  button  set  at  the  default  value  of 
2695  MHz.  Since  we  are  considering  the  same  event  as  discussed  above  enter  Flare  lat  (deg 
N)  =9  and  Flare  Ion  (deg  W)  =2. 
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•  The  Palehula  RISTN  site  observed  a  2695  MHz  fixed  frequeney  radio  emission  event 
beginning  at  0105UT  on  2/20/94  and  reaching  a  maximum  at  01 14UT  with  a  duration  of  85 
minutes  and  a  peak  flux  of  190  SFU.  Edit  the  Event  Onset  Time  text  box  to  read  “02/20/94 
01:05”,  set  Time  of  Maximum  =  “02/20/94  01:14”,  and  SQt  Peak  Radio:  RAD26P(SFU)  =190. 

•  Select  the  Run/Update  option  in  the  Edit  menu  to  execute  PPS  and  a  text  box  will  appear 
containing  the  following  results.  The  Display  Text  button  redisplays  the  text  result. 

-  PPS  -  Proton  PredictionSystem-Version  ' 95  - 


Maximum  day  polar  riometer  absorption  will 
Maximum  night  polar  riometer  absorption  will 

70000  ft  high  flyer  polar  max  dosage  will  be 
50000  ft  high  flyer  polar  max  dosage  will  be 

EVA  max.  astronaut  dosage  will  be 

Inside  [  2  gm/ (sqcm)  ]  max  dosage  will  be 

Protons:  >10  MeV  gt  10  Feb  20  10:00  to  Feb  20 

Protons:  >  5  MeV  gt  10  Feb  20  11:00  to  Feb  21 

Protons:  >50  MeV  gt  10  00  00:00  to  00 


be  1.64  db 

at 

10:51  Feb 

20 

be  0.63  db 

at 

12:22  Feb 

20 

0.0  mR/hr 

at 

08:10  Feb 

20 

0.0  mR/hr 

at 

08:07  Feb 

20 

0.005  R/hr 

at 

10:10  Feb 

20 

0.001  R/hr 

at 

08:55  Feb 

20 

21:00;  max  flux 

of 

1 . 83E+01 

at 

10:01 

Feb 

20 

f luence 

of 

1 . llE+06 

07:00;  max  flux 

of 

2 . 99E+01 

at 

11 : 12 

Feb 

20 

f luence 

of 

1.90E+06 

00:00;  max  flux 

of 

7.44E-01 

at 

08:48 

Feb 

20 

f luence 

of 

4 . 65E+04 

Input  Parameters: 

Input  Type: 

Date  of  onset: 
Time  of  onset: 
Time  of  maximum: 


RAD26PP 

02/20/94 

01:05 

01:14 


Event  lat  (deg  N) : 
Event  Ion  (deg  W) : 
Event  amplitude: 


9.00 

2.00 

1.90E+002 


Expert  mode  parameters: 

Normalization  energy  channel:  0 
Flux  normalization  value:  0 
Time  of  flux  maximum: 00/00  00:00 


Slope  of  integral  spectrum:  0.0 
Slope  of  differential  spectrum:  0.0 


In  the  above  results,  PPS  predicts  that  the  >10  MeV  proton  flux  at  the  Earth,  as  measured  by  the 
GOES  satellite,  will  exceed  a  threshold  of  10  protons/(cm^  s  sr)  for  a  period  beginning  at 
10:00UT  02/20  and  ending  at  21:00UT  02/20/94  with  a  maximum  flux  of  18.3  ptns/(cm^  s  sr)  at 
10:01  02/20/94.  The  same  flux  threshold  will  be  exceeded  by  the  >  5  MeV  flux  beginning  at 
1 1 :00UT  02/20/94  and  ending  at  07:00UT  02/21/94  with  a  maximum  flux  of  29.9  ptns/(cm^  s  sr) 
at  1 1:12  02/20/94.  Eor  the  >  50  MeV  protons  the  threshold  is  never  reached  and  the  maximum 
flux  is  0.744  ptns/(cm^  s  sr)  at  8:48  on  02/20/94.  In  this  example  we  will  not  consider  the  user- 
specified  quantities  that  are  also  displayed  in  the  PPS  output  window.  These  include  polar 
riometer  absorption  forecasts  and  maximum  radiation  dosages  at  specific  altitudes,  and  are 
described  in  the  manual  pages  for  the  PPS  Science  Module. 
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Examining  the  GOES-7  proton  data  for  this  interval  it  can  be  seen  that  the  >  5  and  >10  MeV 
fluxes  both  exceed  the  threshold  value  at  about  03:00E1T  02/20/94.  The  first  maximum  of  the  >  5 
MeV  flux  is  reached  at  about  09:45E1T  02/20/94  and  has  a  value  of  about  220  protons/(cm2  s  sr). 
Eikewise,  the  first  maximum  of  the  >  10  MeV  flux  is  reached  at  about  06:00E1T  02/20/94  and 
has  a  value  of  about  80  ptns/(cm^s  sr).  The  maximum  value  of  the  >  50  MeV  channel  is  reached 
at  roughly  03:00E1T  and  has  a  value  of  about  1.5  ptns/(cm^  s  sr).  Eor  this  event,  PPS  does  a 
reasonable  job  for  the  >  50  MeV  fluxes  and  gets  progressively  worse  for  the  lower  energy 
channels,  overestimating  transit  times  and  underestimating  intensities.  This  event,  however,  turns 
out  to  be  a  fairly  rare  example  of  a  “hybrid”  solar  proton  event.  Besides  the  initial  population  of 
energetic  protons  generated  by  the  energy  release  near  the  Sun  (the  population  that  PPS  is  built 
to  model),  there  is  another  population  of  energetic  protons  reaching  the  Earth  that  is  generated  by 
the  energetic  interplanetary  shock  traveling  towards  the  Earth  (i.e.,  the  shock  that  ISPM  and 
STOA  are  modeling).  Indeed,  after  the  initial  rise  and  a  very  small  decay,  the  >5  and  >10  MeV 
fluxes  rise  again  to  reach  a  maximum  of  4.e+4  and  8.e+3  ptns/(cm^  s  sr),  respectively,  at 
09:00E1T  on  2/21/94.  This  is  exactly  when  the  interplanetary  shock  arrived  at  Earth.  A 
combination  of  an  unexpectedly  strong  shock  with  the  correct  propagation  path  towards  Earth 
made  this  event  one  of  the  strongest  solar  proton  events  of  solar  cycle  22. 

This  completes  the  Example  of  The  Energetic  Solar  Event  of  20  Eebruary  1994. 
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7)  The  Magnetic  Storm  of  13  March  1989  (Dynamic) 

The  following  example  demonstrates  a  dynamie  applieation  of  the  aurora  seienee  module 

(AURORA)  and  a  variety  of  visualization  tools  ineluding  the  ereation  of  a  station,  animation  of 

2-D  and  3-D  coordinate  slices,  and  tracking  of  global  input  parameters. 

Goal:  On  March  13*  1989,  the  second  largest  geomagnetic  storm  in  the  past  50  years  hit  the 
Earth’s  magnetosphere  causing  havoc  with  the  power  grid  serving  Canada’s  Quebec 
province.  At  2:45  AM  EST  (Day  72,  UT  0745)  widespread  geomagnetic  ally  induced 
currents  (GIC)  caused  transformer  saturation  at  the  Hydro-Quebec  power  system  on 
James  Bay  resulting  in  electric  service  outages  for  the  following  nine  hours  in  the 
Quebec  province.  Voltage  fluctuations  were  first  noticed  on  March  12.  The  goal  of 
this  example  is  to  view  the  dynamic  sequence  of  auroral  precipitation  (statistical 
distribution)  as  it  sweeps  over  James  Bay  and  the  Quebec  province  area  in  the  North 
American  sector  in  response  to  changes  in  the  observed  geomagnetic  index  Kp. 

Start  a  dynamic  AE-GEOSpace  session  and  set  global  input  parameters, 

•  Initiate  AE-GEOSpace  via  the  Start  menu  {Start>Programs>AFGeospace>AFGeospace), 
the  desktop  icon,  or  by  double-clicking  on  the  file  $AEGS_HOME\bin\AEGeospace.bat. 
Maximize  the  AE-GEOSpace  user  interface  window.  The  shell  windows  can  be  minimized 
but  must  remain  open  for  AE-GEOSpace  to  function. 

•  Establish  a  dynamic  session  by  placing  a  check  mark  in  the  small  box  to  the  right  of  the 
Start:  UT  text  field  to  activate  the  End:  Year,  Day,  UT  text  fields.  Edit  the  Start  text  fields  so 
that  Year  =  1989,  Day  =  71,  and  UT=  12:00.  Edit  the  End  text  fields  so  that  Year  =  1989, 

Day  =  72,  and  UT=  21:00.  Erom  the  Globals:  selector  options  (on  the  same  bar  as  the  time 
inputs)  pick  Archive  to  automatically  load  parameters  from  the  NGDC  archive. 

•  View  the  global  parameters  for  the  interval  selected  using  the  Globals  menu  (between  the 
Viewport  and  Help  menus  at  the  very  top  of  the  environment  window)  and  selecting  the  Show 
option.  Scroll  down  the  Globals  text  window  that  appears  and  notice  that  the  Kp 
geomagnetic  activity  index  reaches  its  maximum  level  of  9  near  the  end  of  the  interval 
selected.  Dismiss  the  Globals  text  window  using  the  Save  or  Cancel  buttons  at  the  bottom. 

Display  plot  of  Geomagnetic  Index  Kp  in  1-D, 

•  Convert  the  default  3-D  graphics  window  to  a  1-D  window  by  using  the  Viewport  menu, 
selecting  Projection  and  then  the  One  D  option.  (1-D  windows  are  identifiable  by  the  white 
line  framing  the  graphic  window  border).  Note  that  a  1-D  window  can  be  converted  back  to  a 
3-D  window  at  any  time  by  repeating  this  step  and  selecting  the  Three  D  option  instead. 

Also,  converting  a  window  between  1-D  and  2-D  or  3-D  (or  vis-a-versa)  results  in  the  loss  of 
the  graphic  in  the  window  but  not  the  graphics  object  in  the  Graphics  Active  Modules  list. 

•  Select  the  Graphics  option  in  the  Module  menu  and  Available  Modules  and  Active  Modules 
lists  will  appear.  Scroll  down  the  Available  Modules  list  and  select  Global  Inputs.  A  Global 
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Inputs  object  will  be  added  to  the  Active  Modules  list  and  a  set  of  Global  Input  Options  will 
appear  in  the  Environment  Window. 

•  From  the  Value  input  section,  select  the  Kp  option  and  click  Display  to  produce  a  plot  of  Kp 
versus  time.  To  clean  up  this  1-D  plot,  reset  the  Y  Axis  text  fields  Min  =  0.0  and  Max  =  9.0. 
Click  the  mouse  in  any  other  text  field  to  update  the  plot.  This  profile  of  the  geomagnetic 
index  Kp  will  be  used  below  to  drive  a  sequence  of  auroral  precipitation  patterns  to  emulate 
the  March  1989  event.  We  will  retain  this  plot  for  later  viewing. 

Display  Earth  with  Quebec  and  James  Bay  locations, 

•  Select  the  Create  3D  Viewport  option  from  the  Window  menu  and  a  new  3-D  window  will 
fill  the  graphics  area  to  cover  the  1-D  Kp  vs.  time  plot  just  created.  Note  that  there  are  several 
options  are  handling  windows  listed  in  the  lower  part  of  the  Window  menu,  e.g.,  the  two 
existing  windows  can  be  arrange  using  the  Cascade  or  Tile  options.  A  list  of  numbered 
window  references  appear  at  the  bottom  of  the  Window  menu  and  more  are  added  to  the  list 
as  new  windows  are  created,  i.e.,  currently  the  entries  1:1  and  2:2  can  be  used  to  bring  the  1- 
D  and  3-D  windows  to  the  foreground.  Check  that  the  3-D  window  is  currently  being  viewed 
(the  2:2  option  of  the  Window  menu) 

•  Select  the  Graphics  option  in  the  Module  menu  and  Available  Modules  and  Active  Modules 
lists  will  appear.  Select  Earth  from  the  Available  Modules  list.  An  Earth  object  will  be  added 
to  the  Active  Modules  list  and  a  set  of  Earth  Options  will  appear  in  the  Environment  Window. 

•  Under  Outline  Detail,  select  Textured  and  Geographic  Bndys.  Under  Grid  Options  select 
Lat/Lon  Grid,  and  then  select  Display  and  the  Earth  globe  will  appear  in  the  3-D  window. 

•  To  create  and  display  a  station  marker  representing  the  location  of  Quebec  Canada,  scroll 
down  the  Available  Modules  list  and  select  Station  and  a  Station  object  will  be  added  to  the 
Active  Modules  list.  If  Quebec  does  not  appear  on  the  Stations  list,  then  a  new  station  entry 
can  be  added  by  editing  the  four  text  boxes  appropriately,  i.e.,  set  Eat  =  46.80,  Lon  =  -71.25, 
Alt(Re)  =  1 .0,  and  Label  =  “Quebec”  and  click  the  Add  button.  A  highlighted  Quebec  entry 
will  appear  in  the  Stations  list.  Click  Display  and  a  Quebec  marker  will  appear.  Use  the  Pop 
Label  feature  to  make  the  station  always  visible.  Note:  Stations  can  be  removed  from  the  list 
by  highlighting  the  entry  in  the  Stations  list  and  clicking  on  the  Delete  button.  All  changes  to 
the  Stations  list  will  be  saved  for  future  sessions. 

•  Create  and  display  a  station  marker  representing  the  location  of  James  Bay  Canada  by 
repeating  the  last  step  with  the  Station  inputs  set  as  Lat  =  52.0,  Lon  =  -80.0,  Alt(Re)  =  1.0, 
and  Label  =  “James  Bay”.  This  will  result  in  a  second  Station  entry  in  the  Active  Modules 
list.  With  no  data  plotted,  use  the  Viewport  menu  to  turn  off  Show  Color  Bar. 

•  The  Earth’s  size  can  be  scaled  in  the  3D  Window  using  the  right  mouse  button.  With  the 
cursor  in  the  3D  Window,  depress  the  right  button  and  draw  the  mouse  toward  yourself 
Rotate  the  Earth  so  that  the  Quebec  and  James  Bay  location  markers  are  visible  using  the  left 
mouse  button. 
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Generate  a  Dynamic  Auroral  Sequence, 


•  Select  the  Science  option  in  the  Module  menu  and  Available  Modules  and  Active  Modules 
lists  will  appear.  Click  on  AURORA  in  the  Available  Modules  list  and  a  SciAurora  object  will 
be  added  to  the  Active  Modules  list.  A  set  of  AURORA  Options  will  appear  in  the 
Environment  Window. 

•  Select  the  Gridded  Data  option  in  the  Generate  input  section.  Leave  the  Internal  B-Field  and 
External  B-Field  selections  set  at  their  default  values. 

•  Select  the  Dynamic  Tool  option  in  the  Edit  menu  and  a  Dynamic  Tool  option  window  will 
appear.  Place  a  check  mark  in  top  two  rows  of  Variables  noted  at  the  top.  Edit  the  Time  Step 
(sec)  text  field  to  read  10800  seconds  and  click  the  Update  List  button.  These  settings 
indicate  which  available  AURORA  science  model  output  variables  will  be  calculated  during 
the  Start/End  period  at  intervals  of  3  hours  (10800  sec).  Click  the  Done  button  to  register 
your  selections  and  dismiss  the  Dynamic  Tool  window. 

•  Select  the  Run/Update  option  in  the  Edit  menu  and  a  Process  View  Window  will  appear.  As 
the  model  is  completed  for  each  time  step,  the  Model  Status  box  is  updated  to  indicate  the 
model  run  time  and  the  Global  Parameters  Day,  Time,  and  Kp  used.  When  the  complete  set 
of  model  runs  is  complete  the  Process  View  Window  disappears. 

Display  the  Dynamic  Sequence  of  Auroral  Electron  Precipitation  Patterns  in  2-D  and  3-D, 

•  Select  the  Graphics  option  in  Module  menu  and  Available  Modules  and  Active  Modules  lists 
will  appear.  Select  Coord  Slice  and  a  Coord  Slice  object  will  be  added  to  the  Active  Modules 
list.  A  set  of  Coord  Slice  Options  will  appear  in  the  Environment  Window.  Use  the  default 
setting  under  Cut  Plane  option  CO  to  slice  the  data  at  a  constant  radius.  Note  that  the  default 
grid  for  AURORA  consists  only  of  two  constant  radius  caps  at  the  Earth’s  poles. 

•  Click  the  Data  button,  go  to  the  SciAurora  option,  and  select  Elec.  Number  Elux.  Click  in  the 
Display  box  and  auroral  electron  data  will  appear  in  the  3D  Window.  From  the  Viewport 
menu,  use  the  Show  Color  Bar  option  to  show  the  color  bar  with  units  now  representing 
auroral  electron  number  flux.  The  displayed  data  type  can  be  changed  to  view  Ion  or 
conductivity  variables  by  resetting  the  Data  button  in  the  Coord  Slice  Options  window 
(highlight  the  Coord  Slice  entry  of  the  graphics  Active  Module  window  to  view  these 
options). 

•  To  make  the  auroral  display  more  transparent,  click  the  Transparency  button  in  the 
Environment  Window  and  move  the  slider  to  a  value  of  0.70.  Rotate  the  Earth  and  notice  that 
the  auroral  electron  number  flux  is  displayed  at  both  poles. 

•  To  display  a  time  label  in  the  graphics  window,  select  Annotation  from  the  Available 
Modules  list  and  an  Annotation  object  will  be  added  to  the  Active  Modules  list.  A  set  of 
Annotation  Options  will  appear  in  the  Environment  Window.  Place  a  check  mark  in  the  Show 
Date  box  and  click  Display  and  a  time/date  label  will  appear  in  the  far  lower  left  corner  of 
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the  graphic  window.  Move  the  X  and  Y Position  sliders  to  a  value  of  approximately  0.04  to 
make  them  easier  to  read.  The  graphics  window  should  now  resemble  the  following  figure. 


To  view  the  sequence  of  the  aurora,  select  the  Animate  Tool  option  in  the  Edit  menu  and  an 
Animate  window  will  appear.  Reset  the  Time  Step  (sec)  text  field  to  match  the  dynamic  step, 
i.e.,  10800  seconds,  and  click  the  Update  button.  Click  the  Animate  check  box  and  the  time 
slider  will  advance  at  10800-second  increments  and  the  3-D  graphic  will  update 
automatically.  Click  the  Animate  box  again  to  stop  the  animation.  Reset  the  time  slider  to  the 
beginning  by  using  the  slider  arrows  or  manually  moving  the  slider  marker  to  the  far  left. 

Use  the  Viewport  menu  to  select  Projection  followed  by  Two  D  option  and  the  3-D  window 
will  be  converted  to  2-D  while  retaining  the  data  display.  Use  the  Show  Color  Bar  option  in 
the  Viewport  menu  to  remove  the  color  bar.  If  the  Show  Color  Bar  feature  does  not  respond, 
try  highlighting  the  Coord  Slice  entry  in  the  Active  Modules  list  and  retry  the  Show  Color  Bar 
option.  Use  the  Animate  window  (still  open)  to  view  the  changing  aurora  as  in  the  last  step. 

To  track  the  Kp  geomagnetic  activity  index  used  to  generate  this  display,  select  the  Tile 
option  from  the  Window  menu  and  the  Kp  vs  time  plot  will  share  the  graphics  window  space. 
Click  in  the  1-D  window  to  activate  it,  highlight  Annotation  in  the  Active  Modules  list,  and 
click  Display  to  produces  a  time/date  label  in  the  1-D  window.  The  1-D  and  2-D  windows 
should  now  display  the  same  time/date  annotation  label  and  resemble  the  following  figures. 
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•  Use  the  Animate  window  (still  open)  again  to  follow  the  progression  of  Kp  (eurrent  value  is 
indicated  by  marker  dot  in  1  -D  plot)  with  the  changing  auroral  precipitation.  As  Kp  increases 
the  aurora  tends  to  move  to  lower  magnetic  latitudes.  Note  that  this  statistical  representation 
of  the  aurora  indicates  that  the  auroral  electrons  extend  equatorward  over  the  James  Bay  and 
Quebec  area  at  midnight  UT  of  12  March  when  Kp  jumps  to  6.  The  aurora  remains  very 
active  in  this  example  for  the  next  12  hours.  Remember  that  the  actual  Hydro-Quebec  power 
outages  started  occurring  at  0745  UT  on  March  13.  Note  again  that  the  model  represents  only 
a  statistical  pattern  and,  in  fact,  observed  auroral  displays  were  seen  as  far  south  as  the 
Mediterranean  and  Japan. 

This  completes  the  Example  of  The  Magnetic  Storm  of  13  March  1989  (Dynamic) 
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8)  HELIOSpace:  Loading  and  Viewing  PARAMESH  Files  (Dynamic) 

Note:  PARAMESH  data  files  are  not  generated  using  AF-GEOSpaee,  but  a  sample  files  have 
been  provided  for  the  purposes  of  this  example. 

The  following  example  demonstrates  the  use  of  the  Open  Paramesh  option  of  the  File  Menu  and 

the  graphics  modules  PARAMESH-COORDSLICE,  PARAMESH-FIELDLINES,  PARAMESH- 

GRID,  and  PARAMESEl-ISOCONTOUR.  These  features  make  up  the  HEEIOSPACE  viewport 

extension  of  AF-GEOSpace. 

Goal:  This  example  demonstrates  the  procedure  for  loading  and  viewing  MHD  science  code 
simulation  results  stored  in  large-scale  structured  grids  using  the  PARAMESH  file 
format.  These  visualization  capabilities  were  developed  in  collaboration  with  the 
Navel  Research  Eaboratory  (NRL)  for  the  Common  High  Performance  Computing 
(HPC)  Software  Support  Initiative  (CHS SI).  For  more  details  regarding  Paramesh, 
see  the  notes  describing  the  Open  Paramesh  option  in  the  File  menu  documentation 
at  the  beginning  of  this  document.  A  sample  test  file  set  provided  by  NRL  for  this 
AF-GEOSpace  release  will  enable  the  user  to  view  the  dynamic  evolution  of  colliding 
magnetic  flux  tubes  using  the  PARAMESH  graphic  modules  appearing  at  the  end  of 
the  graphics  Active  Modules  list. 

•  Initiate  AF-GEOSpace  via  the  Start  menu  {Start>Programs>AFGeospace>AFGeospace), 
the  desktop  icon,  or  by  double-clicking  on  the  file  $AFGS_HOME\bin\AFGeospace.bat. 
Maximize  the  AF-GEOSpace  user  interface  window.  The  shell  windows  can  be  minimized 
but  must  remain  open  for  AF-GEOSpace  to  function. 

•  Establish  a  dynamic  run  by  placing  a  check  mark  in  the  small  box  to  the  right  of  the  Start: 
UT  text  field  to  activate  the  End:  Year,  Day,  UT  text  fields.  For  this  dynamic  run,  Paramesh 
data  files  will  be  viewed  sequentially  so  the  global  time  interval  and  parameters  can  be 
arbitrary.  From  the  Globals:  selector  options  (on  the  same  bar  as  the  time  inputs)  pick 
Archive  to  automatically  load  parameters  from  the  NGDC  archive.  The  global  parameters  for 
the  Start/End  interval  selected  can  be  viewed  using  the  Globals  menu  and  selecting  the  Show 
option.  The  text  window  that  appears  can  be  dismissed  using  the  Save  or  Cancel  buttons  at 
the  bottom.  Note  that  none  of  these  global  parameters  are  used  as  inputs  for  this  example. 

Load  Paramesh  files, 

•  Choose  File  from  the  menu  bar  of  the  Environment  Window  and  select  the  Open  Paramesh 
option  and  an  Open  popup  window  will  appear. 

•  Use  the  Open  window  to  Look  in  the  folder  containing  the  Paramesh  sample  files,  i.e.,  view 
the  contents  of  $AFGS_HOME\models\data\PARAMESH\CARTESIAN\Sequence.  This 
folder  contains  a  flicks. hdr  file,  a  flicks. ftr  file,  and  a  numbered  set  of flicks.#####  files  with 
one  file  for  each  time  step.  By  default,  the  flicks. hdr  file  is  the  only  one  viewable  with  the 
Open  window. 

•  Select  the  header  file  flicks.hdr  in  the  Sequence  folder  and  click  on  the  Open  button.  After  a 
few  moments  the  Open  window  will  disappear  indicating  that  the  Paramesh  files  have  been 
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loaded.  To  confirm  this,  select  the  Science  option  in  the  Module  menu  and  you  will  find  a 
SciNRLMHD  entry  in  the  Active  Modules  list. 

Activate  a  Heliospace  Viewport 

•  Paramesh  data  files  can  only  be  viewed  in  a  Heliospace  viewport.  To  change  the  currently 
active  graphics  window  for  Heliospace  displays,  choose  the  Viewport  menu,  highlight  the 
Projection  submenu,  and  select  the  HelioSpace  option.  The  active  graphics  window  has  now 
been  assigned  as  a  Heliospace  viewport  and  can  be  used  to  display  Paramesh  data. 

•  Select  the  Graphics  option  in  the  Module  menu  and  Available  Modules  and  Active  Modules 
lists  will  appear.  To  display  a  Heliospace  label  in  the  window,  select  Annotation  from  the 
Available  Modules  list  and  an  Annotation  object  will  be  added  to  the  Active  Modules  list.  A 
set  of  Annotation  Options  will  appear  in  the  Environment  Window.  Enter  “HEEIOSPACE” 
in  the  Text  box  and  click  Display  and  a  label  will  appear  in  the  lower  left  corner  of  the 
graphic  window.  Move  the  X  and  Y Position  sliders  to  a  value  of  approximately  0.04  to 
improve  the  display. 

•  To  also  display  a  time  label  in  the  graphics  window,  select  Annotation  from  the  Available 
Modules  list  and  an  Annotation  object  will  be  added  to  the  Active  Modules  list.  A  set  of 
Annotation  Options  will  appear  in  the  Environment  Window.  Place  a  check  mark  in  the  Show 
Date  box  and  click  Display  and  a  time/date  label  will  appear  in  the  far  lower  left  corner  of 
the  graphic  window.  Move  the,  X Position  slider  to  0.4  and  the  Y Position  sliders  to  0.04  so 
that  the  time/date  label  appears  to  the  right  of  the  HEEIOSPACE  label. 

Display  Paramesh  Grid, 

•  Scroll  down  to  the  bottom  of  the  Available  Modules  list  and  select  ParaMesh-Grid.  A 
ParaMeshGrid  object  will  be  added  to  the  Active  Modules  list  and  a  ParaMesh  Grid  options 
set  will  appear  in  the  environment  window. 

•  Use  the  Data  button  to  select  the  SciNRLMHDO  option  that  corresponds  to  the  Paramesh  data 
set  loaded  earlier.  Click  the  Display  box  on  right  side  of  the  Para-Mesh  Grid  options  window 
and  a  white  grid  cube  will  appear. 

•  Use  the  left/right  mouse  buttons  to  rotate/zoom  in  on  the  cube  and  notice  that  the  structured 
grid  is  composed  of  a  combination  of  blocks  with  sides  of  different  lengths.  At  this  point,  no 
data  are  being  viewed  so  the  color  scale  indicates  a  constant  value.  To  more  easily 
distinguish  the  differently  sized  blocks,  select  the  Level  option  in  the  Color  Method  input 
section.  The  graphic  window  should  resemble  the  following  figure. 
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Display  a  Paramesh  Coordinate  Slice  and  Isocontour, 

•  From  the  Para-Mesh  Grid  environment  window,  select  the  Domain  option  in  the  Render 
Blocks  input  section.  This  changes  the  grid  into  a  gray  colored  domain  background  with 
colored  x  ,  y,  and  z  axes  represented  by  red,  green,  and  blue  arrows,  respectively.  This  Grid 
display  option  is  the  most  favorable  for  viewing  the  other  Paramesh  graphics  objects. 

•  From  the  Available  Modules  list  select  ParaMesh-CoordSlice.  A  Pmesh  Coord  Slice  object 
will  be  added  to  the  Active  Modules  list  and  a  ParaMesh  Coord  Slice  options  set  will  appear 
in  the  environment  window. 

•  Use  the  Data  button  to  highlight  the  SciNRLMHDO  option  then  select  the  Magnetic  Field 
option.  Click  the  Display  box  on  right  side  of  the  Para-Mesh  Grid  options  window  and  one  of 
the  domain  faces,  i.e.,  the  x  =  0  plane,  will  appear  solid  blue.  The  default  Cut  Plane  setting  of 
CO  causes  coordinate  slices  at  constant  x  values  to  be  displayed.  Moving  the  Position  Value 
slider  between  0.0  and  1.0  will  enable  you  to  see  the  initial  structure  of  the  magnetic  flux 
tubes  in  the  domain  space.  The  color  bar  now  corresponds  to  magnetic  field  strength.  To  cut 
through  the  center  of  a  flux  tube  aligned  with  the  z-axis,  move  the  Position  Value  slider  to  a 
value  of  approximately  0.375.  Move  the  slider  to  approximately  0.630  to  see  the  center  of 
another  flux  tube  oriented  on  a  diagonal,  as  well  as  small  portions  of  two  other  flux  tubes  that 
run  parallel  to  the  diagonal  one. 

•  Change  the  Cut  Plane  selection  to  C2  to  view  coordinate  slices  at  constant  z  values.  Move  the 
Position  Value  slider  between  0.0  and  1.0  to  slide  along  the  flux  tube  structures.  Leave  the 
Position  Value  slider  set  at  approximately  0.25. 
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•  From  the  Available  Modules  list  select  ParaMesh-IsoSurface.  A  ParaMesh-IsoSurface  object 
will  be  added  to  the  Active  Modules  list  and  ParaMesh-Isocontour  options  will  appear  in  the 
environment  window. 

•  Use  the  Data  button  to  highlight  the  SciNRLMHDO  option  then  select  the  Magnetic  Field 
option.  Click  the  Display  box  on  right  side  of  the  Para-Mesh  Isocontour  options  window  and 
a  set  of  flux  tubes  will  appear  in  the  form  of  isocontours.  Slide  the  Contour  Value  slider  to 
the  right  until  the  isocontours  become  blue-green  (at  a  value  of  approximately  0.30).  By 
using  the  left  mouse  button,  you  should  be  able  to  rotate  the  picture  until  you  can  see  down 
the  center  of  the  fully- formed  isocontour  tubes  to  see  the  target-like  pattern  formed  by  the 
coordinate  slice  within  each  flux  tube  isocontour.  With  some  adjustment,  the  Heliospace 
viewport  should  resemble  the  following  figure. 
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Animate  the  Flux  Tube  Sequence, 

•  To  view  the  development  of  the  magnetic  flux  tubes  as  they  collide,  we  will  animate  the 
isocontours.  Use  the  Edit  menu  and  select  the  Animate  Tool  option  and  an  Animate  window 
will  appear.  The  animation  start  and  end  times  are  the  default  dynamic  time  fields  from  the 
top  of  the  environment  window.  For  a  sequence  of  Paramesh  data  files,  the  file  suffix 
numbers  are  used  to  display  the  simulation  output  in  the  proper  order  with  the  lowest  and 
highest  numbered  files  corresponding  to  the  animation  start  and  end  times,  respectively.  To 
begin  continuous  animation,  place  a  check  mark  in  the  Animate  box  under  the  time  slider. 
The  animate  slider  will  progress  at  900-second  time  steps  and  the  magnetic  flux  tubes  will 
change  every  four  hours.  Note  that  to  get  the  animation  time  to  correspond  correctly  with  the 
simulation  time,  the  proper  Start  and  End  times  would  need  to  be  entered  at  the  top  of  the 
environment  window  at  the  very  beginning  of  this  exercise.  Stop  the  animation  by  clicking 
again  in  the  Animate  box.  Reset  the  picture  by  moving  the  time  slider  to  the  far  left. 
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•  To  view  the  sequenee  a  single  frame  at  a  time,  move  the  time  slider  manually  to  the  right. 
Again,  the  data  will  be  updated  every  4  hours.  The  fourth  frame  of  the  sequenee  should 
resemble  the  next  figure. 


Prepare  for  viewing  magnetic  field  lines  structures, 

•  Turn  off  the  coordinate  slice  display  by  highlighting  the  Pmesh  Coord  Slice  entry  in  the 
Active  Modules  list  (on  the  right  side)  and  removing  the  check  mark  from  Display. 

•  Reset  the  Animation  window  time  slider  to  the  far  left  position. 

•  Make  the  isocontours  slightly  transparent  by  highlighting  the  ParaMesh-Isocontour  entry  in 
the  Active  Modules  list,  selecting  the  Transparency  option,  and  setting  the  Transparency 
slider  that  appears  at  the  bottom  of  the  window  to  a  value  of  0.25. 

Display  and  Probe  Magnetic  Field  Line  Structure, 

•  From  the  Available  Modules  list  select  ParaMesh-FieldLines.  A  ParaMeshFieldLine  object 
will  be  added  to  the  Active  Modules  list  and  a  Para  Mesh  Field  Lines  options  set  will  appear 
in  the  environment  window.  Remove  the  check  mark  from  the  Start  Planes  XMid  option. 

•  To  view  single  magnetic  field  lines,  select  the  User  Defined  option  (below  the  Data  button) 
and  the  selection  options  will  change.  Use  the  Data  button  to  highlight  the  SciNRLMHDO 
option  and  then  select  the  Magnetic  Field  option. 

•  Click  the  Add  button  and  the  Current  Field  Line  selector  will  show  a  Field  Line  0  entry. 
Click  Display  and  a  green  dot  will  appear  in  the  center  of  the  domain.  Due  to  the  weak  field 
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strength  at  this  location,  no  field  line  is  traced.  Move  ihe  X Position  slider  to  -0.3  and  a  field 
line  should  be  visible  inside  the  vertical  fiux  tube. 

•  Click  the  Add  button  again  and  the  Current  Field  Line  selector  will  show  a  Field  Line  1 
entry.  Move  the  X  Position  slider  to  0.45  and  a  field  line  will  appear  wrapped  around  the 
diagonally  oriented  fiux  tube.  Use  the  left  mouse  button  to  rotate  the  graphic  and  view  the 
field  lines  from  different  angles.  To  change  the  settings  of  either  field  line,  use  the  Current 
Field  Line  selector  to  view  the  entry  of  interest  and  adjust  the  settings  for  that  line.  The 
tracing  direction  can  be  adjusted  using  the  Direction  selector  near  the  bottom  of  the  window. 
Note  that  these  field  line  starting  points  remain  fixed  in  space  when  the  Animate  Tool  is  used. 

•  To  improve  the  appearance  of  the  field  lines,  perform  the  following  tasks:  (1)  set  the  Line 
Width  selector  to  2,  (2)  set  the  Render  As  selection  to  Cylinders,  and  (3)  click  the  Color 
selector  and  click  the  mouse  in  the  red  part  of  the  color  wheel  that  appears.  The  Heliospace 
window  should  now  resemble  the  following  figure. 


This  completes  the  Example  HELIOSpace:  Loading  and  Viewing  PARAMESH  Files. 
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9)  lONSCINT:  Ionospheric  Scintillation  Simulation  (V2.5.1  Only,  Dynamic) 

The  following  dynamic  example  demonstrates  the  use  of  the  ionospheric  scintillation  simulation 

lONSCINT  Science  Module,  the  COORDSLICE  Graphics  Module,  Animation,  and  a  variety  of 

other  visualization  tools. 

Goal:  This  example  exercises  the  lONSCINT  science  module  for  two  separate  time 

intervals.  The  user  chooses  which  interval  to  investigate  then  follows  the  same  set  of 
steps  to  obtain  the  plots  using  AF-GEOSpace.  In  the  first  scenario  option,  we 
examine  scintillation  in  the  South  America  sector  at  one-hour  intervals  such  that  all 
plots  are  generated  using  a  single  scenario  representing  a  single  evening.  As  time 
progresses,  scintillation  structures  appear  about  one  hour  to  the  East  of  the  day/night 
terminator.  These  structures  begin  near  the  equator,  grow  in  latitudinal  extent  and 
drift  eastward  with  the  drifting  ionosphere,  then  begin  to  decay  in  intensity.  In  the 
second  scenario,  we  examine  the  height  of  the  scintillation  season  over  Africa  by 
looking  at  one-day  intervals  showing  the  high  degree  of  day-to-day  variability  in 
scintillation  produced  by  lONSCINT. 

Start  a  dynamic  AF-GEOSpace  session  and  set  global  input  parameters, 

•  Initiate  AF-GEOSpace  via  the  Start  menu  {Start>Programs>AFGeospace>AFGeospace), 
the  desktop  icon,  or  by  double-clicking  on  the  fide  $AFGS_HOME\bin\AFGeospace.bat. 
Maximize  the  AF-GEOSpace  user  interface  window.  The  shell  windows  can  be  minimized 
but  must  remain  open  for  AF-GEOSpace  to  function. 

•  Establish  a  dynamic  session  by  placing  a  check  mark  in  the  small  box  to  the  right  of  the 
Start:  UT  text  field  to  activate  the  End:  Year,  Day,  UT  text  fields.  To  enter  the  date  and  time 
inputs  for  the  South  America  {Africa)  scenario,  edit  the  Start  text  fields  so  that  Year  =  2000 
(1999),  Day  =  75  (69),  and  UT=  00:00  (21:00)  and  edit  the  End  text  fields  so  that  Year  = 
2000  (1999),  Day  =  15  (74),  and  UT=  06:00  (21:00).  From  the  Globals:  selector  options  (on 
the  same  bar  as  the  time  inputs)  pick  Archive  to  automatically  register  the  time  interval  and 
load  parameters  from  the  NGDC  archive.  The  only  global  parameters  that  can  affect 
lONSCINT  are  the  Day,  UT,  Kp  and  SSN,  however,  in  both  scenarios  described  here  we  will 
opt  for  the  constant  input  option. 

Display  the  Earth  in  2-D, 

•  Select  the  Graphics  option  in  the  Modules  menu  and  Available  Modules  and  Active  Modules 
lists  will  appear.  Select  Earth  from  the  Available  Modules  list.  An  Earth  object  will  be  added 
to  the  Active  Modules  list  and  a  set  of  Earth  Options  will  appear  in  the  bottom  of  the 
Environment  Window. 

•  Under  Outline  Detail  select  the  Textured  and  Geographic  Bndys  options.  Under  Grid  Options 
select  the  Lat/Lon  Grid  option.  Click  in  the  Display  box  to  place  the  Earth  in  the  default  3D 
window.  The  left  and  right  mouse  buttons  can  be  used  to  rotate  and  scale  the  Earth  image 
while  the  cursor  is  in  the  Window. 
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•  From  the  Viewport  menu,  seleet  Projection  and  then  the  Two  D  option.  The  graphie  window 
eontaining  the  Earth  will  ehange  to  2-D.  The  spaee  to  the  right  of  the  Earth  graphie  will  be 
filled  later  with  a  data  eolor  bar.  The  eenter  and  right  mouse  buttons  ean  be  used  to  translate 
and  seale  the  Earth  image. 

Generate  Dynamie  lONSCINT  Data, 

•  Choose  Module  from  the  Menu  Bar  and  seleet  Science  from  the  options.  Available  Modules 
and  Active  Modules  lists  will  appear.  Seroll  down  and  seleet  lONSCINT  from  the  Available 
Modules  list.  A  SeilonScintO  objeet  will  appear  in  the  Active  Modules  list  and  lONSCINT 
Options  will  appear  in  the  Environment  Window. 

•  Eor  the  South  Ameriea  (Afriea)  seenario,  set  the  Random  Number  Seed  =  -12345  (-123). 
Under  Theater  enter  Lat  1  =  -40  (-20),  Lat  2  =  40  (40),  Lon  i  =  250  (-20),  and  Lon  2  =  330 
(60)  and  just  below  that  set  Satellite  Longitude  =  260  (2).  In  the  Sunspot  Number  and  KP 
input  seetion  ehoose  the  Constant  option  and  enter  SSN=  100  (100)  and  Kp  =  2.0  (1.0). 

Seleet  the  Operational  Mode  ealled  Plume  and  enter  Scintillation  Intensity  =  0.5  (0.5)  and 
Percentile  for  S4  to  dB  Fade  =  99.5  (90.5).  Note  that  the  ealeulation  is  automatieally 
performed  on  a  grid  with  1 -degree  spaeing  and  Grid  Tool  ehanges  will  NOT  alter  this 
default. 

•  Eor  the  South  Ameriea  (Afriea)  seenario,  we  will  run  lONSCINT  onee  every  hour  (day). 
Seleet  the  Dynamic  Tool  option  in  the  Edit  menu  and  a  Dynamic  Tool  option  window  will 
appear.  Eeave  the  eheck  marks  in  all  boxes  next  to  all  four  variables  listed  for  lONSCINT, 
i.e.,  Sdindex,  dBFade,  ProbCom,  and  SatElev.  Edit  the  Time  Step  (sec)  text  field  to  read  3600 
(86400)  seeonds  and  eliek  the  Update  List  button.  The  list  in  the  lower  part  of  the  Dynamie 
Tool  window  should  now  be  updated  to  show  that  lONSCINT  will  be  run  onee  every  hour 
(day).  Cliek  the  Done  button  to  register  you  seleetions  and  dismiss  the  Dynamic  Tool 
window. 

•  Seleet  the  Run/Update  option  in  the  Edit  menu  to  start  the  ealeulation.  A  Process  View 
window  appears  briefly.  The  Model  Status  window  at  the  bottom  of  the  Environment 
Window  will  indieate  the  lONSCINT  run  times.  Beeause  we  seleeted  the  Constant  option  for 
speeifying  the  SSN  and  Kp,  the  values  shown  in  the  Model  Status  window  represent  global 
arehive  data  and  will  not  be  used  in  these  seenarios. 

Display  a  Time/Date  Eabel  in  the  Aetive  Graphie  Window, 

•  Seleet  the  Graphics  option  in  the  Modules  menu  and  Available  Modules  and  Active  Modules 
lists  will  appear.  SQlQCi  Annotation  from  i\\Q  Available  Modules  list.  Nn  Annotation  objeet 
will  be  added  to  the  Active  Modules  list  and  a  set  of  Annotation  Options  will  appear  in  the 
bottom  of  the  Environment  Window. 

•  To  display  a  time  label  in  the  graphies  window,  plaee  a  eheck  mark  in  the  Show  Date  box 
and  click  Display  and  a  time/date  label  will  appear  in  the  far  lower  left  comer  of  the  graphic 
window.  Move  ths  X Position  and  Y Position  sliders  to  a  value  of  approximately  0.04  to 
make  them  easier  to  read. 

310 

Approved  for  public  release;  Distribution  is  unlimited. 

AF-GEOSpace  User’s  Manual:  Version  2.5.1 


Display  and  Animate  a  Dynamic  Sequence  of  lONSCINT  Scintillation  Results, 

•  To  display  the  S4  scintillation  index  output,  return  to  the  Available  Modules  list  and  select 
Coord  Slice.  A  Coord  Slice  object  appears  in  the  Active  Modules  list  and  a  set  of  Coord  Slice 
options  appears  in  the  Environment  Window.  Click  on  the  Data  button,  go  down  to 
ScilonScintO  and  choose  S4Index.  Click  Display  to  display  the  S4  Index  pattern  in  the  2D 
Window. 

•  While  the  cursor  is  in  the  graphics  window,  use  the  center  and  right  mouse  buttons  to 
translate  and  rescale  the  image,  respectively,  so  that  the  theater  almost  fills  the  window. 
Select  the  Transparency  feature  on  the  right  side  of  the  Environment  Window  and  move  the 
Transparency  slider  that  appears  to  a  value  of  0.50. 

Eor  the  South  America  scenario,  the  graphic  should  resemble  the  following  figure. 


Eor  the  Africa  scenario,  the  graphic  should  resemble  the  following  figure. 
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•  To  see  the  position  of  the  geosynehronous  satellite  assoeiated  with  this  scintillation  pattern, 
click  on  the  Data  button,  go  down  to  ScilonScintO  and  choose  SatElev. 

For  the  South  America  scenario,  notice  that  the  spacecraft  is  located  directly  above  the 
geographic  equator  just  west  of  South  America  as  shown  in  the  following  figure. 


For  the  Africa  scenario,  notice  that  the  spacecraft  is  located  directly  above  the  geographic 
equator  and  off  the  Ivory  Coast  as  shown  in  the  following  figure. 


•  Use  the  Data  button  to  reset  the  data  display  to  show  S4Index.  Select  the  Animate  Tool 

option  in  the  Edit  menu  and  an  Animate  window  will  appear.  For  the  South  America  (Africa) 
scenario,  reset  the  Time  Step  (sec)  text  field  to  match  the  dynamic  step,  i.e.,  3600  (86400) 
seconds,  and  click  the  Update  button.  Click  the  Animate  check  box  and  the  time  slider  will 
advance  at  3600-second  (86400-second)  steps  and  the  2-D  graphic  will  update  automatically. 
Note  that  you  can  change  the  Data  button  select  while  the  animation  is  continuing  to 
examine  other  parameters. 
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Click  the  Animate  box  again  to  stop  the  animation.  Manually  move  the  time  slider  in  the 
Animate  window  to  the  far  left.  Use  the  arrows  at  the  ends  of  the  slider  to  view  the  data  one 
step  at  a  time.  The  seenario  sequenee  should  resemble  the  following  figure  sets. 

South  Ameriea  Seenario  S4Index:  01:00  -  06:00  03/15/2000  (00:00  shown  above)  - 
Scintillation  structures  appear  about  one  hour  to  the  East  of  the  day/night  terminator.  These 
struetures  begin  near  the  equator,  grow  in  latitudinal  extent  and  drift  eastward  with  the 
drifting  ionosphere,  then  begin  to  decay  in  intensity. 
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Africa  Scenario  S4Index;  21:00  03/10/1999  -  03/15/1999  -  These  plots  illustrate  the  height  of 
the  seintillation  season  over  Africa  at  one-day  intervals  and  show  the  high  degree  of  day-to- 
day  variability  in  seintillation  produeed  by  lONSCINT. 
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10)  The  Magnetospheric  Cusp  and  Auroral  Equatorward  Boundary 

The  following  example  demonstrates  the  use  of  the  AURORA  Seienee  Module,  the  magnetie 

field  BFIELD-APP  Module,  COORD-SLICE  and  EIELD-LINES  Graphie  Modules,  and  a 

variety  of  other  visualization  tools. 

Goal:  Magnetospherie  magnetie  fields  eontribute  to  the  partiele  preeipitation  patterns 

observed  in  the  polar  eaps,  i.e.,  the  magnetie  eusp  is  assoeiated  with  a  peak  in  ion 
preeipitation  near  noon  magnetie  loeal  time  and  plasma  sheet  eleetrons  follow 
magnetie  field  lines  down  to  the  ionosphere  to  form  the  auroral  oval.  To  illustrate 
these  magnetie  field-partiele  preeipitation  eonneetions,  the  goal  of  this  example  is 
two-fold:  (1)  Examine  the  loeation  of  the  magnetospherie  eusp  and  its  mapping  as 
determined  by  several  magnetie  field  models  in  relation  to  statistieally  determined 
auroral  ion  number  fluxes;  (2)  Examine  the  loeation  of  the  equatorward  boundary  of 
the  auroral  region,  as  determined  by  the  eleetron  number  flux,  and  visualize  its 
magnetie  eonneetion  to  the  equatorial  region  of  the  magnetosphere. 

Start  an  AE-GEOSpaee  session  and  set  global  input  parameters, 

•  Initiate  AF-GEOSpaee  via  the  Start  menu  {Start>Progmms>AFGeospace>AFGeospace), 
the  desktop  ieon,  or  by  double-elieking  on  the  fide  $AFGS_HOME\bin\AFGeospaee.bat. 
Maximize  the  AF-GEOSpaee  user  interfaee  window.  The  shell  windows  ean  be  minimized 
but  must  remain  open  for  AF-GEOSpaee  to  funetion. 

•  Eor  this  run,  set  the  date  and  time  in  the  Environment  Window  by  editing  the  text  boxes  to 
read:  Start :Year=\993,  Day=8\,  and  f/J'=09:00.  Seleet  the  Archive  option  using  the  Globals 
seleetor  to  the  right  of  the  time  inputs  and  the  values  of  the  Kp  geomagnetie  index,  sunspot 
number  (SSN),  E10.7  em  radio  flux,  and  the  Ap  geomagnetie  index  for  this  time  will  be 
eopied  from  arehived  NGDC  parameters  (Kp=4.3,  SSN=73,  F  10.7=126.6,  andd/»=32).  Note 
that  the  modules  aeeessed  in  this  example  will  not  use  SSN,  E10.7,  and  Ap. 

Create  and  plot  an  aurora  ion  data  set, 

•  Seleet  the  Science  option  from  the  Modules  menu  and  Available  Modules  and  Active  Modules 
lists  will  appear.  Cliek  on  AURORA  in  Ono  Available  Modules  list.  Pen  AURORA  objeet  will 
appear  in  the  Active  Modules  list  and  a  set  of  AURORA  Options  will  appear  in  the 
Environment  Window. 

•  Leave  the  Generate,  Internal  B-Eield,  and  External  B-Eield  inputs  seleetions  as  Gridded 
Data,  Centered  Dipole,  and  None,  respeetively.  Seleet  the  Grid  Tool  option  in  the  Edit  menu 
and  a  Grid  Tool  window  will  appear.  Note  that  the  radius  minimum  and  maximum  settings 
are  the  same  beeause  the  default  auroral  grid  is  a  surfaee  at  ionospherie  altitude.  To  get  a 
smoother  eontour  plot,  inerease  NPoint  in  the  Eat,  GEOC  (Deg  N)  seetion  to  100  and 
inerease  Npoint  in  the  Lon,  GEOC  (Deg  E)  seetion  to  96.  Hit  the  OA  button  to  generate  the 
grid  and  elose  the  Grid  Tool  Window. 
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Select  the  Run/Update  option  in  the  Edit  menu  and  a  Process  View  window  will  appear.  The 
Model  Status  box  will  show  the  global  parameters  used  and  indicate  that  the  model  is  ready 
after  the  Process  View  window  disappears. 

Click  on  the  Modules  menu  and  select  Graphics.  Available  Modules  and  Active  Modules  lists 
will  appear.  Select  Earth  from  the  Available  Modules  list.  An  Earth  object  will  be  added  to 
Active  Modules  list  and  a  set  of  Earth  Options  will  appear. 

Under  Outline  Detail  leave  Geographic  Bndys  checked  off  and  under  Grid  Options  select 
Lat/Lon  Grid.  Click  in  the  Display  box  to  place  the  Earth  in  the  default  3-D  window. 

While  the  cursor  is  in  the  graphic  window,  the  left  and  right  mouse  buttons  can  be  used  to 
rotate  and  resize  the  view  of  Earth,  respectively.  Use  the  right  mouse  button  to  rescale  the 
view  so  that  the  Earth  fills  a  large  portion  of  the  window.  Now  use  the  left  mouse  button  to 
rotate  the  Earth  downward  so  you  can  view  the  North  Pole. 

Erom  the  Available  Modules  list  select  Coord  Slice.  A  Coord  Slice  object  will  be  added  to  the 
Active  Modules  list  and  a  set  of  Coord  Slice  Options  will  appear  in  the  Environment 
Window.  Click  on  the  Data  button  and  select  Ion  Number  Flux  under  the  SciAurora  options 
list  that  appears.  Click  in  the  Display  box  to  view  the  ion  number  flux.  To  make  geographic 
features  visible  through  the  ion  precipitation  pattern,  click  the  Transparency  button  and  a 
slider  appears.  Move  the  Transparency  slider  to  a  value  0.80. 


To  further  highlight  the  peak  flux  region  select  the  Contours  and  Color  options  in  the 
Display  Options  input  section  and  move  the  Number  of  Contours  slider  to  a  value  of  25. 
Notice  the  flux  maximum  near  80  degrees  geographic  latitude  just  east  of  the  Greenwich 
meridian.  The  corresponding  maximum  in  the  southern  hemisphere  appears  on  the  coast  of 
Antarctica  at  a  longitude  of  approximately  90  degrees.  The  view  of  the  northern  hemisphere 
should  resemble  the  figure  above. 
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Create  and  plot  eusp  region  magnetie  flux  tubes, 


•  To  eheck  the  location  of  magnetic  field  model  cusps  relative  to  the  ion  number  flux  we  will 
plot  magnetic  flux  tubes  centered  about  their  respective  magnetic  cusps.  If  centered  properly, 
the  flux  tube  field  lines  will  continue  to  spread  as  they  approach  the  magnetopause.  Some 
field  lines  will  pass  through  the  magnetic  equator  and  connect  to  the  opposite  hemisphere 
while  others  are  swept  anti-sunward  into  the  magnetotail. 

•  B-field  Case  1:  Return  to  the  Modules  menu  and  select  Applications.  Available  Modules  and 
Active  Modules  lists  will  appear.  Select  BFIELD-APP  from  the  Available  Modules  list.  An 
AppBField  object  will  appear  in  the  Active  Modules  list  and  B-Field  Application  Parameters 
options  will  appear  in  the  Environment  Window. 

•  Under  Generate  check  the  Flux  Tube  option  (the  Gridded  Data  and  MLT Field  Lines  options 
will  not  be  used  and  can  be  unchecked).  Under  Internal  B-Field  select  the  IGRF  (1945-2010) 
option.  Under  External  B-Eield  select  the  Hilmer-Voigt  ’95.  Choose  the  Kp  Only  default 
option  in  the  Hilmer-Voigt  ‘95  Options  Window  that  appears  and  click  the  Done  button  to 
dismiss  the  window. 

•  Set  the  Elux  Tube  Inputs  coordinates  to  Geographic  and  set  Lat=15,  Long=2\,  Alt(km)=0, 
Diam(km)=600,  and  Steps=40.  Select  the  Run/Update  option  in  the  Edit  menu.  The  Process 
View  window  will  appear  momentarily  and  the  Model  Status  box  will  show  the  dipole  tilt 
angle  (-4.1  degrees)  and  the  Hilmer-Voigt  model  settings  that  correspond  to  the  global  Kp  = 
4.3,  i.e.,  magnetopause  standoff  distance  of  8.6  Re,  Dst  =  -20  nT,  and  Eq.  Edge  =  59.51 
degrees. 

•  Choose  the  Modules  menu  and  select  the  Graphics  option.  Available  Modules  and  Active 
Modules  lists  will  appear.  Scroll  down  and  select  Field  Lines  from  the  Available  Modules 
list.  A  FieldLines  object  will  appear  in  the  Active  Modules  list  and  a  set  of  Field  Fines 
Options  will  appear  in  the  Environment  Window. 

•  Click  on  the  Data  button,  slide  down  to  AppBField,  and  select  the  Flux  Tube  option.  Click 
Display  to  view  the  field  lines.  Click  the  Color  button  and  use  the  left  mouse  button  to  click 
in  the  yellow  region  of  the  color  wheel  that  appears  so  that  the  field  lines  will  change  from 
the  default  green  color  to  become  yellow.  Select  the  Smooth  Fine  Type  option  and  increase 
the  Line  Width  to  2. 

•  Use  the  right  mouse  button  while  the  cursor  is  in  the  graphic  window  to  zoom  out  until  field 
lines  can  be  seen  hitting  the  southern  hemisphere.  Some  field  lines  connect  to  the  southern 
hemisphere  while  others  hit  the  magnetopause.  Now  zoom  in  very  close  until  only  the 
footprint  of  the  flux  tube  is  showing  and  notice  that  the  magnetic  cusp  in  this  model  is 
centered  a  few  degrees  equatorward  of  the  statistical  ion  number  flux  maximum  shown  in  red 
in  both  hemispheres. 

•  B-field  Case  2;  Return  to  the  Modules  menu  and  select  Applications.  Available  Modules  and 
Active  Modules  lists  will  appear.  Select  BFIELD-APP  from  the  Available  Modules  list  on  the 
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left  and  a  second  AppBField  object  will  appear  in  the  Active  Modules  list  and  B-Field 
Application  Parameters  options  will  appear  in  the  Environment  Window. 

Under  Generate  check  the  Flux  Tube  option  (the  Gridded  Data  and  MLT Field  Lines  options 
will  not  be  used  and  can  be  unchecked).  Under  Internal  B-Field  select  the  IGRF(1945-2010) 
option.  Under  the  External  B-Field  option  select  the  Olson-Pfitzer  “77  option. 

Set  the  Flux  Tube  Inputs  coordinates  to  Geographic  and  set  Lat=S3,  Long=l3,  Alt(km)=0, 
Diam(km)=600,  and  Steps=40.  Select  the  Run/Update  option  in  the  Edit  menu.  The  Process 
View  window  will  appear  momentarily  and  the  Model  Status  box  will  show  the  dipole  tilt 
angle  (-4.1  degrees).  Note  that  this  model  does  not  use  the  global  inputs  displayed,  but  rather 
represents  an  average  quiet  state  of  the  magnetosphere. 

Choose  the  Modules  menu  and  select  the  Graphics  option.  Available  Modules  and  Active 
Modules  lists  will  appear.  Scroll  down  and  select  Field  Lines  from  the  Available  Modules  list 
on  the  left.  A  second  FieldLines  object  will  appear  in  the  Active  Modules  list  and  a  set  of 
Field  Fines  Options  will  appear  in  the  Environment  Window. 

Click  on  the  Data  button,  slide  down  to  the  second  AppBField  entry,  and  select  the  Flux  Tube 
option.  Click  Display  to  view  the  field  lines.  Click  the  Color  button  and  use  the  left  mouse 
button  to  click  in  the  very  center  of  the  color  wheel  so  that  the  new  field  lines  appear  white. 
Select  the  Smooth  Fine  Type  option  and  increase  the  Line  Width  to  2. 

Zoom  in  to  see  that  the  Olson-Pfitzer  model  magnetic  cusp  is  several  degrees  poleward  of  the 
ion  number  flux  maximum  in  both  hemispheres. 

B-field  Case  3:  Return  to  the  Modules  menu  and  select  Applications.  Available  Modules  and 
Active  Modules  lists  will  appear.  Select  BFIELD-APP  from  the  Available  Modules  list  on  the 
left  and  a  third  AppBField  object  will  appear  in  the  Active  Modules  list  and  B-Field 
Application  Parameters  options  will  appear  in  the  Environment  Window. 

Under  Generate  check  the  Flux  Tube  option  (the  Gridded  Data  and  MLT  Field  Lines  options 
will  not  be  used  and  can  be  unchecked).  Under  Internal  B-Field  select  the  IGRF  (1945-2010) 
option.  Under  External  B-Field  select  the  Tsyganenko  ‘89  option.  Click  OK  in  the 
Tsyganenko  (1989)  Options  window  that  appears  to  use  the  default  iQ?  Only  option. 

Set  the  Flux  Tube  Inputs  coordinates  to  Geographic  and  set  Lat=l%,  Long=\%,  Alt(km)=0, 
Diam(km)=600,  and  Steps=40.  Select  the  Run/Update  option  in  the  Edit  menu.  The  Process 
View  window  will  appear  momentarily  and  the  Model  Status  box  will  show  the  dipole  tilt 
angle  (-4.1  degrees)  and  the  Kp  =  4-,  4,  4+  version  of  the  model  used. 

Choose  the  Modules  menu  and  select  the  Graphics  option.  Available  Modules  and  Active 
Modules  lists  will  appear.  Scroll  down  and  select  Field  Lines  from  the  Available  Modules  list 
on  the  left.  A  third  FieldLines  object  will  appear  in  the  Active  Modules  list  and  a  set  of  Field 
Fines  Options  will  appear  in  the  Environment  Window. 
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•  Click  on  the  Data  button,  slide  down  to  the  third  AppBField  entry,  and  select  the  Flux  Tube 
option.  Click  Display  to  view  the  field  lines.  Click  the  Color  button  and  change  the  new  field 
lines  to  be  red.  Select  the  Smooth  Line  Type  option  and  increase  the  Line  Width  to  2. 

•  Zoom  in  and  notice  that  the  Tsyganenko  ‘89  red  cusp  fiux  tube  seems  centered  fairly  well 
about  the  ion  number  flux  maximum. 

Compare  Magnetic  Field  Model  Cusp  Locations, 

•  Cusp  comparisons  can  be  made  by  using  the  mouse  button  to  rotate  and  scale  the  picture 
while  selectively  turning  the  field-line  displays  on  and  off.  Hide  a  set  of  field  lines  by 
selecting  one  of  the  FieldLines  objects  listed  in  the  Active  Modules  list  and  clicking  the 
Display  button.  Remember  that  the  active  graphic  objects  and  the  data  sets  are  listed  in  the 
order  produced:  Hilmer-Voigt  ‘95  (Yellow),  Olson-Pfitzer  “77  (White),  and  Tsyganenko  ‘89 
(Red).  By  viewing  one  set  of  cusp  field  lines  at  a  time  and  selecting  the  Filled  Surface  Plot 
Type  option  the  true  funnel  formed  by  the  cusp  magnetic  field  lines  becomes  more  evident. 

•  To  duplicate  the  next  figure  you  must  use  the  Viewport  menu  to  uncheck  Show  Color  Bar 
and  then  rotate  and  scale  the  view  with  the  left  and  right  mouse  buttons,  respectively. 


Display  the  equatorward  boundary  of  the  aurora  mapped  out  along  magnetic  field  lines, 

•  Choose  the  Science  options  of  the  Modules  menu  and  Available  Modules  and  Active  Modules 
lists  will  appear.  Select  Hf/ROTM  in  the  Available  Modules  list.  A  second  SciAurora  object 
will  appear  in  the  Active  Modules  list  and  a  set  of  AURORA  Options  will  appear  in  the 
Environment  Window. 
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Under  Generate  check  the  Eq  Edge  option  and  uncheck  the  Gridded  Data  option.  Select  the 
IGRF  (1945-2010)  Internal  B-Field  option  and  the  Tsyganenko  ‘89  External  B-Field  option. 
Choose  the  Kp  Only  option  in  the  Tsyganenko  (1989)  Options  window  that  appears  and  click 
OK.  Leave  the  Equatorward  Edge  Parameter  and  Model  input  sections  unchanged. 

Select  the  Run/Update  option  in  the  Edit  menu  and  a  Process  Window  will  appear.  The 
Model  Status  box  will  show  the  global  parameters  used  and  indicate  that  the  model  is  ready 
after  the  Process  Window  vanishes. 

Select  Graphics  from  the  Modules  menu  and  turn  off  the  Hilmer-Voigt  (yellow)  and  Olson- 
Pfitzer  (white)  cusp  flux  tubes  by  removing  the  check  mark  in  the  Display  box  while  the  first 
and  second  FieldLines  Graphics  Objects  are  highlighted  in  the  Active  Modules  list. 

Click  on  Field  Lines  in  the  Available  Modules  list  that  appears  and  a  fourth  FieldLines  object 
appears  in  the  Active  Modules  list  and  a  set  of  Field-Lines  Options  appears.  Click  the  Data 
button,  slide  down  to  the  second  SciAurora  option  listed,  and  select  Mapped  Eq.  Edge.  Click 
Display  to  see  the  field  lines  mapped  from  the  electron  equatorward  boundary  corresponding 
to  the  Kp  =  4.3  global  input  parameter. 

To  improve  the  picture,  select  the  Filled  Surface  Plot  Type  option  and  remove  the  check 
mark  from  the  Field  Lines  option.  Next  activate  the  Transparency  option  and  move  its  slider 
to  a  value  of  0.50.  Now  use  the  Lights  option  and  select  Enable  (lower  left  of  Lighting 
Parameters  that  appear)  to  add  a  diffuse  lighting  source.  The  graphic  should  now  resemble 
the  following  figure. 


Magnetic  Cusp  with  Electron 
Equatorward  Boundary  Surface 
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•  The  labels  were  added  using  the  annotation  feature.  To  plaee  a  label  in  the  aetive  graphics 
window,  select  Annotation  from  the  Available  Modules  list  and  an  Annotation  object  will  be 
added  to  the  Active  Modules  list.  A  set  of  Annotation  Options  will  appear  in  the  Environment 
Window.  Type  the  desire  label  in  the  Text  field  and  click  Display.  The  position  of  the  label 
can  be  adjusted  using  X Position  and  Y Position  sliders.  Two  separate  annotations  were 

used  for  the  figure  above. 

This  completes  the  Example  of  The  Magnetospheric  Cusp  and  Auroral  Equatorward  Boundary. 
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11)  Low  Earth  Orbit  Total  Dose 

The  following  example  demonstrates  the  use  of  the  APEXRAD  Seienee  and  Applieation 

Modules,  the  Satellite  Applieation  Module  (SATEL-APP),  the  Orbit  Sliee  and  Orbit  Probe 

Graphie  Modules,  and  a  variety  of  visualization  tools. 

Goal:  View  the  total  radiation  dose  distribution  eneountered  by  the  low  Earth  orbit  Defense 
Meteorologieal  Satellite  Program  (DMSP)  satellite.  Contributions  are  from  the  South 
Atlantie  Anomaly  (SAA),  where  unusually  high  fluxes  of  inner  zone  partieles 
(predominantly  protons)  are  eneountered  due  to  the  asymmetry  of  the  Earth’s 
magnetie  field,  and  from  the  high  latitude  /  low  altitude  projeetion  of  the  outer 
radiation  belt  MeV  eleetron  population.  (See  Example  2  for  an  illustration  of  the 
individual  eleetron  and  proton  populations  impaeting  the  low  Earth  orbit  partiele 
environment) 

Start  an  AE-GEOSpaee  session  and  set  global  input  parameters, 

•  Initiate  AE-GEOSpaee  via  the  Start  menu  {Start>Progmms>AFGeospace>AFGeospace), 
the  desktop  ieon,  or  by  double-elieking  on  the  fide  $AEGS_HOME\bin\AEGeospaee.bat. 
Maximize  the  AE-GEOSpaee  user  interfaee  window.  The  shell  windows  ean  be  minimized 
but  must  remain  open  for  AE-GEOSpaee  to  funetion. 

•  Eor  this  run,  set  the  date  and  time  in  the  Environment  Window  by  editing  the  text  boxes  to 
read:  Start : Year=\991 ,  Day=299,  and  177'=08:30.  This  date  is  eonsistent  with  the  referenee 
time  of  the  orbit  elements  to  be  used.  Seleet  the  Globals:  Archive  option  from  the  seleetor  to 
the  right  of  the  time  inputs  and  the  Kp,  SSN,  E10.7,  and  Ap  values  appear  that  are 
appropriate  for  this  time  (although  they  will  not  be  used  in  this  example). 

Create  APEXRAD  Seienee  Module  data  set, 

•  Seleet  Science  from  the  Modules  menu  options  and  Available  Modules  and  Active  Modules 
lists  will  appear.  Cliek  on  APEXRAD  in  the  Available  Modules  list  and  a  SciApexDose  objeet 
will  be  added  to  the  Active  Modules  list  and  a  set  of  APEXDOSE  Options  will  appear  in  the 
Environment  Window. 

•  Cliek  on  the  B-Model  button  and  seleet  the  IGRF95  option  to  generate  a  realistieally 
positioned  South  Atlantie  Anomaly  (SAA)  for  Eow  Earth  Orbit  (EEO)  altitudes  relatively 
quiekly.  Note  that  IGRF95/0-P  model  was  used  to  eonstruet  CRRESPRO  but  it  takes 
eonsiderably  longer  to  run.  Also,  while  the  offset-tilted  dipole  option  Dip-Tilt-Off  is  fastest,  it 
does  not  yield  a  realistieally  positioned  SAA. 

•  Use  the  Shielding  button  to  seleet  232.5  mil  Al,  eorresponding  to  the  shielding  thiekness  of 
the  hemispherie  dome  number  3  of  the  APEX  satellite. 

•  Eeave  the  Channel  button  set  at  the  default  ealled  Total  to  represent  the  sum  of  the  High  EET 
(Einear  Energy  Transfer)  and  Eow  EET  dose  ehannels. 
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•  Click  on  the  Activity  button  to  see  that  there  are  several  aetivity  ranges  represented 
(parameterized  by  the  15-day  average  Ap  index),  plus  an  average  aetivity  level  for  the  whole 
mission.  Seleet  the  Whole  Mission  model  (default). 

•  Seleet  the  Grid  Tool  option  from  the  Edit  menu  and  a  Grid  Tool  window  will  appear.  Leave 
the  default  Spacing,  Geometry,  and  System  settings  unehanged.  In  the  Rad,  GEOC  (Re) 
seetion  set  Npoint=40,  Min=\.\  Re,  andMax=3.0  Re.  In  the  Lat,  GEOC  (Deg  N)  seetion  set 
Npoint=60,  Min=  -70°,  andMax=+70°.  In  the  Eon,  GEOC  (Deg  E)  section  set  Npoint=60, 
Min=  -180°,  andMax=+180°.  Cliek  the  OA  button  to  register  the  grid  ehoices  and  elose  the 
Grid  Tool  window. 

•  Select  the  Run/Update  option  in  the  Edit  menu  and  a  Process  View  window  will  appear. 
When  eomplete  the  Process  Window  will  disappear  and  the  identifieation  and  status  of  the 
model  will  appear  in  the  Model  Status  box  in  the  lower  part  of  the  Environment  Window. 

Create  the  DMSP  orbit  data  set, 

•  Erom  the  Modules  menu,  seleet  Applications  and  Available  Modules  and  Active  Modules  lists 
will  appear.  Seroll  down  the  Available  Modules  list  and  seleet  SATEL-APP  (satellite 
applieation).  An  AppSatel  object  will  be  added  to  the  Active  Modules  list  and  a  set  of 
Ephemeris  Data  options  will  appear  in  the  Environment  Window. 

•  With  the  Element  Type  set  as  From  File,  elick  on  the  File  button  to  view  the  Open  window. 
Highlight  the  file  “dmsp.txt”  in  the  folder  $AEGS_HOME\models\data\EPHEMERIS  and 
eliek  the  Open  button.  Highlight  DMSPF14  in  the  Current  Element  File  list  of  satellites.  The 
orbital  elements  for  DMSPP14  ean  be  viewed  by  seleeting  the  Mean  option  in  the  “Element 
Type”  input  section.  Reselect  the  From  File  option  to  return  to  the  previous  view. 

•  The  referenee  time  T_ref  (01/1 1/99,  03:43:39)  and  default  run  interval  {T  stop  -  T_start  =  1 
day)  are  shown  in  the  text  boxes  below.  Eeave  T_start  set  at  “07/19/97  8:30:00”  but  ehange 
the  T  stop  text  box  to  read  “07/19/97  15:30:00”  to  setup  a  7-hour  orbit  run.  Seleet  the 
Run/Update  option  in  the  Edit  menu  and  a  Process  Window  will  appear  momentarily.  When 
eomplete,  Wq  Model  Status  box  indieates  the  “MODEE  IS  READY  AND  UP  TO  DATE.” 

Display  the  Earth,  Satellite  Orbit,  and  Time  Eabel  in  3-D, 

•  Seleet  Graphies  from  the  Modules  menu  and  Available  Modules  and  Active  Modules  lists  will 
appear.  Seleet  Earth  from  the  Available  Modules  list  and  an  Earth  objeet  will  be  added  to  the 
Active  Modules  list.  A  set  of  Earth  Options  appears  in  the  Environment  Window. 

•  Seleet  the  Outline  Detail  options  Textured  and  Geographic  Bndys.  Cliek  Display  and  the 
Earth  will  appear  in  the  default  3D  window.  The  left,  center  (or  shift  key  +  left),  and  right 
mouse  buttons  ean  be  used  to  rotate,  translate,  and  reseale,  respeetively,  the  eontents  of  the 
graphics  window.  Alternatively,  the  image  orientation  may  be  set  using  the  Viewport  menu 
(seleet  View  Position  and  then  the  E/ew... options). 
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•  Scroll  down  the  Available  Modules  list  and  select  Satellite.  A  Satellite  object  will  be  added  to 
the  Active  Modules  list  and  a  set  of  Satellite  Options  will  appear  in  the  Environment 
Window.  Pick  the  Satellite  selection  DMSPF14,  click  the  Label  button  and  select  Sat.  Name, 
check  the  Pop  Label  box,  and  click  Display.  The  DMSP  orbit  (in  the  geocentric  reference 
frame)  will  appear  in  the  window  with  the  satellite  name  (solid  red  circle).  With  no  data 
selected,  the  color  bar  appearing  reads  “No  Data”. 

•  To  display  a  time  label  in  the  graphics  window,  select  Annotation  from  the  Available 
Modules  list  and  an  Annotation  object  will  be  added  to  the  Active  Modules  list.  A  set  of 
Annotation  Options  will  appear  in  the  Environment  Window.  Place  a  check  mark  in  the  Show 
Date  box  and  click  Display  and  a  time/date  label  will  appear  in  the  far  lower  left  comer  of 
the  graphic  window.  Move  the,  X Position  and  Y Position  sliders  to  a  value  of  0.04. 

Display  and  Animate  Satellite  and  Orbit  slices  in  3-D  and  2-D, 

•  Return  to  the  Available  Modules  list  and  select  Orbit  Slice.  An  OrbitSlice  Object  will  be 
added  to  the  Active  Modules  list  and  a  set  of  Orbit  Slice  options  will  appear.  Pick  the  Satellite 
selection  DMSPF14  and  click  the  Data  button  and  select  Dose  under  the  SciApexDose 
option.  In  the  Orbit  Planes  section,  select  the  PO  and  P2  options  to  generate  data  slices  slaved 
to  the  satellite’s  radial  and  longitudinal  positions.  The  coordinate  geometry  of  the  planes  is 
determined  by  the  Grid  Tool  selections  made  earlier,  i.e.,  a  spherical  geographic  coordinates. 

•  (Optional  step)  To  improve  the  display  appearance,  click  on  the  Transparency  button  and 
move  the  Transparency  slider  to  a  value  of  0.80  to  make  the  continent  outlines  more  visible 
through  the  data.  Next,  click  on  the  Color  Map  button  and  a  Color  Map  Editor  will  appear. 
Click  on  the  small  light-blue  box  anchoring  the  left  end  of  the  blue  segment  and  drag  it 
downward  very  slightly  until  the  dose  data  in  the  region  over  southeastern  South  American 
becomes  greenish  in  color. 

•  This  session  is  referred  to  as  being  a  static  one  because  the  environment  is  calculated  for  a 
single  time.  The  results  of  the  satellite  applications,  however,  can  still  be  animated.  Select 
Animate  Tool  from  the  Edit  menu  and  an  Animate  window  will  appear.  Edit  the  Time  End 
text  to  read  “07/19/97  15:30”,  change  the  Time  Step  to  360  seconds,  and  click  the  Update 
button.  Click  the  Animate  box  and  the  satellite  and  slaved  orbit  slices  will  move  at  360- 
second  steps.  Click  the  Animate  box  again  to  stop  the  animation. 

•  Reset  the  Animate  window  time  slider  to  the  far  left,  i.e.,  to  08:30.  Use  the  time  slider  end 
arrows  to  forward  the  animation  to  07/09/1997  1 1:54.  DMSP  P14  should  now  be  directly 
over  the  South  American  coast  in  the  middle  of  the  South  Atlantic  Anomaly  (SAA)  and  the 
graphic  should  resemble  the  next  figure. 

•  Prom  the  Viewport  menu,  select  the  Projection  then  Two  D.  The  viewport  will  change  its 
dimensionality  and  retain  all  data.  Remove  the  color  bar  to  make  more  room  by  using  the 
Viewport  menu  and  deactivate  the  Show  Color  Bar  option.  Click  the  Animate  box  in  the 
Animate  window  to  move  the  satellite.  The  dose  data  does  not  change  because  the  satellite 
altitude  is  nearly  constant.  You  might  notice  that  the  orbit  path  seems  to  appear  slightly 
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above  and  below  the  eurrent  satellite  altitude  at  various  times.  Click  the  Animate  box  again  to 
stop  the  animation.  The  graphic  should  resemble  the  following  figure. 


Generate  a  one-dimensional  plot  of  the  APEXRAD  dose  as  seen  by  the  DMSP  satellite, 

•  To  create  a  new  window  to  display  ID  results  use  the  Window  menu  and  select  the  Create 
ID  Viewport  option.  A  blank  graphics  window  with  a  white  line  just  inside  the  frame  will 
appear.  Use  the  Window  menu  and  select  the  Tile  option  to  fit  both  open  windows  neatly  in 
the  available  graphics  window  space. 
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Click  in  the  1-D  window  to  activate  it  and  then  highlight  the  Annotation  entry  in  the  Active 
Modules  list  on  the  left.  The  Annotation  Options  will  reappear.  Cliek  Display  and  the  same 
time/data  label  used  in  the  3-D  window  will  appear  in  the  1-D  window. 

Return  to  the  Available  Modules  list  on  the  left  and  seleet  Orbit  Probe.  An  Orbit  Probe 
objeet  will  be  added  to  the  Active  Modules  list  and  a  set  of  Orbit  Probe  options  will  appear  in 
the  Environment  Window.  Use  the  Path/Abscissa  button  to  seleet  AppSatel  (representing  the 
DMSPF14  satellite)  and  then  the  Time  option.  Use  the  Data/Ordinate  button  to  seleet 
SciApexDose  and  then  Dose.  The  two  data  selection  buttons  should  now  read  “Time”  and 
“Dose”.  Click  Display  and  a  dose  vs.  time  plot  will  appear  in  the  active  1-D  window. 

The  Dose  values  are  small  numbers  so  the  y-axis  labels  appear  as  0.00  in  the  default  labeling 
format.  To  adjust  the  y-axis  labels,  edit  the  Y  Axis  section  Format  text  box  to  read  “%1.2e” 
to  use  an  exponential  format.  Now  reset  the  Y  Axis  section  text  boxes  to  Min  =  0.00  and  Max 
=  0.0008.  Cliek  in  any  other  text  box  to  register  the  changes.  The  1-D  window  should 
resemble  the  following  figure. 


Use  the  Animate  window  so  that  the  satellite  markers  in  both  the  2D  and  ID  plots  step  along 
(in  360  seeond  steps)  in  phase  with  eaeh  other  as  the  satellite  periodieally  eneounters  peak 
flux  in  the  SAA.  Remember  that  the  APEX  data  in  the  2D  Window  is  set  to  traek  the 
satellite’s  altitude. 

(Optional)  To  switch  the  Earth  plot  between  2-D  and  3-D,  eliek  in  the  2-D  window  to 
activate  it.  Now  use  the  Projection  option  of  the  Viewport  menu  and  select  Two  D  or  Three 
D.  This  can  be  done  while  animating. 

(Optional)  To  see  both  the  2-D  and  3-D  plots  simultaneously,  maximize  the  2-D  window  to 
fill  the  screen.  Now  use  the  Viewport  menu  to  Split  the  graphic  window  with  the  Horizontal 
option.  This  will  ereate  two  identieal  2-D  views  staeked  in  the  graphic  window.  Click  in  one 
of  the  graphie  frames  to  aetivate  it  and  use  the  Viewport  menu  to  ehange  the  Projection  to 
Three  D.  Use  the  left  and  right  mouse  buttons  in  the  3-D  window  to  rotate  and  rescale  the  3- 
D  image.  To  remove  one  of  the  two  visible  windows,  click  in  the  frame  to  aetivate  it  then 
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select  the  Delete  option  from  the  Viewport  menu.  To  find  the  1-D  plot  again,  use  the 
Cascade,  Tile,  or  2:2  options  in  the  Window  menu.  The  last  option  is  so  named  owing  to  the 
fact  that  the  1-D  viewport  was  the  second  one  created  (the  1:1  option  corresponds  to  original 
window  which  is  either  2-D  or  3-D  depending  on  which  steps  you  took  above). 

Run  the  APEXRAD  Application  Module  to  determine  approximate  annual  doses  for  the 

specified  DMSP  orbit, 

•  Choose  Modules  from  the  Menu  Bar  and  select  Applications  from  the  options.  Available 
Modules  and  Active  Modules  lists  will  appear.  Click  on  APEXRAD-APP  in  the  Available 
Modules  list  and  an  AppApexRad  object  will  be  added  to  the  Active  Modules  list.  A  set  of 
Ephemeris  Data  options  will  appear.  These  options  are  similar  to  those  used  by  the  Satellite 
Application  we  used  above. 

•  With  Element  Type  left  set  as  From  File,  click  on  the  File  button  to  view  the  Open  window. 
Highlight  the  file  “dmsp.txt”  in  the  folder  $AEGS_HOME\models\data\EPHEMERIS  and 
click  the  Open  button.  Highlight  DMSPF14  in  the  Current  Element  File  list  of  satellites.  The 
orbital  elements  for  DMSPE14  can  be  viewed  by  selecting  the  Mean  option  in  the  Element 
Type  input  section.  Reselect  the  From  File  option  to  return  to  the  previous  view. 

•  The  reference  time  T_ref  (01/1 1/99,  03:43:39)  and  default  run  interval  {T  stop  -  T_start  =  1 
day)  are  shown  in  the  text  boxes  below.  Select  the  Run/Update  option  in  the  Edit  menu  and  a 
Process  Window  appears.  When  complete,  a  scrolling  text  window  will  appear  with  orbit- 
averaged  dose,  normalized  to  1  year,  for  the  various  channels  and  model  activities.  The  text 
window  is  two  full  pages  long  and  will  not  be  reproduced  here.  The  OK  button  dismisses  the 
text  box.  To  redisplay  it,  use  the  Show  Text  button  in  the  Ephemeris  Data  options. 

This  completes  the  Example  of  the  Eow  Earth  Orbit  Total  Dose 
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12)  Geomagnetic  Cutoff  Rigidity  (Dynamic) 

The  following  example  demonstrates  the  use  of  the  Geomagnetie  Vertieal  Cutoff  Rigidity 

Interpolation  Model  (CUTOFF  Seienee  Module),  the  SATEL-APP  Module,  and  visualization 

tools  ineluding  the  COORD-SLICE,  ORBIT-SLICE,  and  ORBIT-PROBE  Graphieal  Modules. 

Goal:  Cosmie  rays  are  very  energetie  partieles  that  penetrate  the  Earth’s  magnetie  field  to 
different  depths  and  eontribute  to  the  radiation  dose  aeeumulated  by  spaeeeraft.  The 
magnetie  rigidity  of  a  partiele  is  a  measure  of  its  resistanee  to  a  magnetie  field  that 
defleets  it  from  a  straight-line  trajeetory.  Generally,  partieles  with  higher  rigidities  are 
more  likely  to  gain  aeeess  to  a  given  loeation  inside  the  magnetosphere.  The  goal  of 
this  example  is  to  examine  ehanges  in  the  effeetive  rigidity  of  the  geomagnetic  cutoff 
along  the  Space  Station  orbit  during  a  period  of  time  when  the  geomagnetic  activity 
was  increasing,  i.e.,  as  the  three-hour  Kp  index  increased  from  1+  to  8+. 

Start  an  AE-GEOSpace  session  and  set  global  input  parameters 

•  Initiate  AF-GEOSpace  via  the  Start  menu  (Start  >  Programs  >  AEGeospace  >  AEGeospace), 
the  desktop  icon,  or  by  double-clicking  on  the  file  $AFGS_HOME\bin\AEGeospace.bat. 
Maximize  the  AE-GEOSpace  user  interface  window.  The  shell  windows  can  be  minimized 
but  must  remain  open  for  AF-GEOSpace  to  function. 

•  The  following  steps  will  create  an  18 -hour  dynamic  session  during  an  interval  of  increasing 
geomagnetic  activity.  Set  the  global  “Start”  time  parameters  such  that  Tear=1998,  Day=261, 
and  f/J'=  12:00.  Now  place  a  check  mark  in  the  box  to  the  right  of  the  UT  text  field  to 
designate  a  dynamic  run  (this  activates  the  End  time  input  fields)  and  set  the  parameters 
“End:  Year”=1998,  Day=26S,  UT=06:00.  Click  on  the  Globals:  Archive  option  to  the  right  of 
the  time  input  fields  to  register  the  selected  time  interval  and  the  corresponding  set  of  NGDC 
archived  global  input  parameter  to  be  used  during  this  session.  View  the  list  of  inputs  by 
selecting  the  Show  option  of  the  Globals  pulldown  menu.  The  Globals  popup  window  shows 
that  the  value  of  Kp  increases  from  1.3  to  8.3  during  the  interval,  i.e.,  from  1+  to  8+.  Close 
the  Globals  window  using  the  Cancel  button. 

Create  an  International  Space  Station  (ISS)  orbit  data  set 

•  Select  the  Applications  option  in  the  Module  menu.  Available  Modules  and  Active  Modules 
lists  will  appear.  Scroll  down  the  Available  Modules  list  and  select  SATEL-APP  (satellite 
application).  An  AppOrbit  object  will  be  added  to  the  Active  Modules  list  and  a  set  of 
Ephemeris  Data  options  will  appear  in  the  Environment  Window 

•  Leave  From  File  as  the  selected  Element  Type  option.  Click  on  the  File  button  and  a  window 
will  appears  showing  the  contents  of  the  folder  $AEGS_HOME\models\data\EPHEMERIS. 
Click  on  the  file  icon  labeled  “iss.txt”  and  click  the  Open  button. 

•  Select  the  one  option  appearing  in  the  Current  Element  File  list  in  the  middle  of  the  window, 
i.e.,  highlight  the  “ISS  (ZARYA)”  entry.  The  satellite  name  and  the  reference  time  (T_ref) 
associated  with  the  orbital  elements  are  given  in  boxes  below  the  list  box.  To  view  the 
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orbital  elements  for  any  satellite  loaded  using  the  From  File  option,  eliek  on  the  Mean 
element  type  button.  Reseleet  the  From  File  element  type  button  to  return  to  the  previous 
view.  When  run  in  dynamie  mode,  the  start  and  stop  times  {T_start  and  T  stop)  for  the 
satellite  are  automatieally  set  to  mateh  the  time  interval  entered  earlier. 

•  Seleet  the  Run/Update  option  in  the  Edit  menu  to  ereate  the  orbit  data  set.  When  eompleted, 
the  Model  Status  box  will  indieate  that  the  “MODEL  IS  READY  AND  UP  TO  DATE.” 

Create  3D  view  of  the  Earth  with  an  orbit  traee 

•  Seleet  the  Graphics  option  from  the  Module  menu.  Available  Modules  and  Active  Modules 
lists  will  appear.  Seleet  Earth  from  the  Available  Modules  list.  An  Earth  objeet  will  be 
added  to  the  Active  Modules  list  and  a  set  of  Earth  Options  will  appear  in  the  Environment 
Window.  Seleet  “Outline  Detail”  options  Textured  and  Geographic  Bndys.  Cliek  on  Display 
and  the  Earth  will  appear  in  the  default  3D  graphics  Window. 

•  Scroll  down  the  Available  Modules  list  and  select  Satellite.  A  Satellite  object  will  be  added 
to  the  Active  Modules  list  and  a  set  of  Satellite  Options  will  appear.  Click  the  Satellite  list 
and  choose  ISS  (ZARYA).  Leave  the  Data  button  set  to  “No  Data”  and  the  Label  button  set  to 
Sat.  Name.  Check  the  Pop  Label  option  and  then  click  Display  and  the  space  station  orbit 
will  appear  in  the  3D  window. 

Create  a  Cutoff  Science  Module  data  set  for  the  18-hour  interval 

•  Select  the  Science  option  from  the  Modules  menu.  Available  Modules  and  Active  Modules 
lists  will  appear.  Scroll  through  the  Available  Modules  list  and  click  on  CUTOFF.  A 
SciGeoMagCutoff  object  will  be  added  to  the  Active  Modules  list. 

•  The  Geomagnetic  Vertical  Cutoff  Rigidity  Interpolation  Model  is  driven  by  Kp  and  Time 
from  the  global  parameters  already  registered  so  no  other  inputs  are  required.  Because  the 
cutoff  rigidity  model  results  are  derived  using  both  a  fixed  internal  (IGRF  1995)  and  a  time- 
dependent  external  {Tsyganenko  [1989])  geomagnetic  field  model,  the  cutoff  rigidity  values 
will  change  with  time  even  when  Kp  remains  constant.  To  reflect  this  time-dependence,  in 
the  following  step  we  will  calculate  model  output  every  6  hours,  i.e.,  every  21600  seconds. 

•  Select  the  Dynamic  Tool  option  from  the  Edit  menu  and  the  Dynamic  Tool  popup  window  for 
the  CUTOFF  module  will  appear.  Place  check  marks  in  the  top  row  of  output  parameters 
(i.e.,  L,  INVLT,  PTV,  and  RCGVPV),  reset  the  Time  Step  (sec)  =  21600,  and  click  the 
Update  List  button.  The  updated  window  now  indicates  that  four  model  runs  will  be 
performed  and  that  the  four  selected  parameters  will  be  calculated  for  each  grid  point.  Click 
the  Done  button  to  register  these  choices  and  to  close  the  window.  The  3D  grid  to  be 
processed  can  be  examined  by  selecting  the  Grid  Tool  option  of  the  Edit  menu. 

•  Select  the  Run/Update  option  in  the  Edit  menu  to  create  the  Geomagnetic  Cutoff  data  set. 
When  completed,  the  Model  Status  box  will  show  the  Kp  values  actually  used  at  each  time 
step  and  indicate  that  the  “MODEL  IS  READY  AND  UP  TO  DATE.” 
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Create  a  3D  view  of  the  Effective  Cutoff  Rigidity 

•  Select  the  Graphics  option  from  the  Module  menu.  Available  Modules  and  Active  Modules 
lists  will  appear.  Select  Coord  Slice  from  the  Available  Modules  list.  A  Coord  Slice  Object 
will  be  added  to  the  Active  Modules  list  and  a  set  of  Coord  Slice  Options  will  appear  in  the 
Environment  Window.  Click  the  Data  button  and  select  RCGVPV  (effective  cutoff  rigidity  in 
GV  in  the  vertical  direction)  under  the  SciCeoMagCutoff  option.  Select  the  C2  Cut  Plane 
option  and  select  Display  to  place  a  constant  longitude  coordinate  slice  in  the  3D  window. 

•  Move  the  Position  Value  slider  to  longitude  =  -108  degrees  (Position  Value  =  0.200).  After 
rotating  the  Earth  and  zooming,  the  3D  display  should  resemble  the  figure  above.  This 
display  helps  to  emphasize  the  fact  that  the  CUTOEE  Science  Module  covers  the  3D  space 
from  low  earth  orbit  out  to  beyond  geostationary  orbit. 
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•  Change  the  displayed  filled  coordinate  slice  to  reveal  colored  contours  at  the  current 
coordinate  slice  location  by  doing  the  following.  In  the  Display  Options  section,  uncheck  the 
Filled  option  and  then  place  check  marks  in  both  the  Contours  and  Color  option  boxes.  The 
plot  should  now  resemble  the  figure  above. 

•  Next  we  will  animate  the  dynamic  sequence  to  observe  how  the  rigidity  contours  change  as 
Kp  increases  (remember  that  Kp  increases  steadily  with  time  during  this  interval).  To 
animate  the  contours,  start  by  opening  the  Animate  Tool  in  the  Edit  menu.  To  match  the  step 
used  in  the  Dynamic  Tool  earlier,  set  Time  Step  (Sec)  =  21600  and  click  Update.  Now  click 
on  the  slider’s  right  arrow  to  advance  the  time  by  this  new  time  step.  Note  that  the  rigidity 
contours  move  equatorward  as  magnetic  activity  increases  owing  to  the  overall  weakening  of 
the  magnetic  field.  Thus  energetic  particles  typically  penetrate  deeper  into  the  magnetosphere 
during  geomagnetic  storm  events.  Use  the  Done  button  to  close  the  Animate  window. 

Create  a  2D  View  of  Rigidity  at  Space  Station  Altitude 

•  Scroll  down  the  Available  Modules  list  and  select  Orbit  Slice.  An  Orbit  Slice  object  will  be 
added  to  the  Active  Modules  list  and  a  set  of  Orbit  Slice  Options  will  appear.  Use  the  Satellite 
selector  to  pick  “ISS  (ZARYA)”.  Click  the  Data  button  and  select  RCGVPV (effective  cutoff 
rigidity  in  GV  in  the  vertical  direction)  under  the  SciGeoMagCutoff  option.  Remove  the 
check  from  the  Geocentric  option  so  as  not  to  replot  the  orbit.  Select  the  PO  option  under 
“Orbit  Planes”  (to  produce  a  coordinate  slice  of  constant  radius  slaved  to  the  satellite’s 
altitude)  and  leave  the  Filled  Display  Option  selected.  Check  the  Display  button  to  display 
cutoff  values.  Select  Transparency  and  change  the  slider  setting  to  0.5. 

•  Use  the  Viewport  menu  to  select  Projection  and  then  its  Two  D  option.  All  data  is  now 
project  on  a  2D  Earth.  Note  that  the  constant  longitude  coordinate  slice  contours  appear  as  a 
straight  vertical  line  cutting  through  the  Americas.  Return  to  Active  Modules  and  highlight 
Satellite.  Under  “Reference  Frame”,  uncheck  Geocentric  and  select  Inertial.  Highlight  the 
Coord  Slice  entry  in  the  Active  Modules  list  to  refresh  the  color  bar  label.  The  2D  window 
should  resemble  the  figure  below.  Note  that  you  can  get  back  to  a  3-D  view  by  using  the 
Projection  option  of  the  Viewport  menu  and  select  Three  D. 
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Display  a  ID  Rigidity  data  set  along  the  ISS  orbit  traek 

•  Use  the  Window  menu  to  seleet  Create  ID  Viewport  and  an  empty  1-D  graphies  window  will 
appear.  Note  that  the  Window  menu  options  Cascade  and  Tile  can  be  used  to  access  the 
existing  original  3-D  window. 

•  Scroll  through  the  Available  Modules  list  and  click  on  Orbit  Probe.  An  Orbit  Probe  object 
will  be  added  to  the  Active  Modules  list  and  an  Orbit  Probe  Option  Panel  will  appear  in  the 
Environment  Window.  Click  on  the  Path/Abscissa  button  and  select  the  Time  option  under 
AppOrbit.  Click  on  the  Data/Ordinate  button  and  select  the  RCGVPV option  under 
SciGeoMagCutoffKp.  Click  Display  and  a  plot  of  RCGVPV  vs.  Time  for  the  ISS  orbit  will 
appear. 

•  Click  on  Orbit  Probe  in  the  Available  Modules  list  again.  A  second  Orbit  Probe  object  will 
be  added  to  the  Active  Modules  list.  Click  on  the  Path/Abscissa  button  and  select  the  Time 
option  under  AppOrbit.  Click  on  the  Data/Ordinate  button  and  select  the  Latitude  option 
under  AppOrbit.  Click  Display  and  a  plot  of  Latitude  vs.  Time  for  the  ISS  will  appear.  In  the 
Y-axis  Options  section,  select  the  Right  button  to  move  the  labels  to  the  other  side  of  the  plot. 
Remove  the  redundant  x-axis  by  removing  the  check  from  the  X  Axis  Enabled  box.  The  ID 
plot  should  now  resemble  the  next  figure. 


The  final  figure  below  (not  generated  as  part  of  this  example)  was  made  using  the  Orbit  Probe 
module  and  shows  the  RCGVPV  parameter  along  the  ISS  orbit  when  Kp  is  held  constant  at  Kp  = 
1.3  (red  line)  and  Kp  =  8.3  (white  line).  The  cutoff  values  (in  GV)  peak  near  the  geomagnetic 
equator  and  are  larger  for  the  low  Kp  case,  i.e.,  the  overall  geomagnetic  field  values  are  stronger 
for  this  case  and  thus  particles  need  more  energy  to  penetrate  to  those  locations.  The  RCGVPV 
curve  in  the  figure  above  would  fall  between  the  red  and  white  curves  in  the  figure  below. 
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cr  U  CD  >  Q.  > 


ISS  (ZARYA)  :  Time  vs.  ISS  (ZARYA)  :  Latitude 


Time  (UT) 


This  completes  the  Example  of  the  Geomagnetic  Cutoff  Rigidity 


333 

Approved  for  public  release;  Distribution  is  unlimited. 
AF-GEOSpace  User’s  Manual:  Version  2.5.1 


13)  Meteor  Impact  Hazards 

The  following  example  demonstrates  the  use  of  the  Meteor  Impaet  Seienee  Module,  the  Meteor 

Sky  Map  Seienee  Module,  the  Meteor  Impaet  Applieation  Module  and  a  variety  of  visualization 

tools. 

Goal:  View  the  meteor  flux  and  eounts  of  two  eoineident  meteor  showers  with  a  user- 
defined  storm  inserted  in  both  2D  and  3D.  Fly  a  satellite  through  the  meteor 
environment  and  ereate  a  ID  plot  of  meteor  flux  along  the  satellite  path  that  ineludes 
the  eumulative  impaet  probability. 

Start  an  AF-GEOSpaee  session  and  set  global  input  parameters 

•  Initiate  AF-GEOSpaee  via  the  Start  menu  (Start  >  Programs  >  AEGeospaee  >  AEGeospaee), 
the  desktop  ieon,  or  by  double-elieking  on  the  fide  $AEGS_HOME\bin\AEGeospaee.bat. 
Maximize  the  AF-GEOSpaee  user  interfaee  window.  The  shell  windows  ean  be  minimized 
but  must  remain  open  for  AE-GEOSpaee  to  funetion. 

•  Eor  this  statie  run,  set  the  Global  Parameters  as  follows:  Start:Year=l995,  Day=225, 
UT=\2:00.  Cliek  on  the  Globals:  Archive  option  to  the  right  of  the  time  input  fields  to 
automatieally  load  the  set  of  NGDC  parameters  for  this  time  (Kp=2,  SSN=9,  FIO.  7=12.1 ,  and 
Ap=l). 

Create  the  DMSP  orbit  data  set 

•  Seleet  the  Applications  option  in  the  Module  menu.  Available  Modules  and  Active  Modules 
lists  will  appear.  Seroll  down  the  Available  Modules  list  and  seleet  SATEL-APP  (satellite 
applieation).  An  APPOrbit  objeet  will  be  added  to  the  Active  Modules  list  and  a  set  of 
Ephemeris  Data  options  will  appear  in  the  Environment  Window 

•  Eeave  the  From  File  Element  Type  option  seleeted  and  eliek  on  the  File  button  and  a 
window  will  appears  showing  the  eontents  of  the  folder 

$AEGS_HOME\models\data\EPHEMERIS.  Cliek  on  the  file  ieon  labeled  “dmsp.txt”  and 
eliek  the  Open  button. 

•  A  list  of  DMSP  satellites  will  appear  in  the  Current  Element  File  list  in  the  middle  of  the 
window.  Seleet  DMSP  F8  (USA  26).  The  satellite  name  and  the  referenee  time  assoeiated 
with  the  orbital  elements  are  given  in  boxes  below  the  list  box.  To  view  the  orbital  elements 
for  any  satellite  loaded  using  the  From  File  option,  eliek  on  the  Mean  element  type  button. 
Reseleet  the  From  File  element  type  button  to  return  to  the  previous  view.  The  default  value 
for  the  start  time  (“T_Starf ’)  is  taken  from  the  global  values  at  the  top  of  the  Environment 
Window.  Whenever  a  SATEE-APP  module  is  run  in  “statie”  mode,  a  1-day  interval  with  a 
60-seeond  time  step  is  used  by  default. 

•  Seleet  the  Run/Update  option  in  the  Edit  menu  to  ereate  the  orbit  data  set.  When  eompleted, 
the  Model  Status  box  will  indieate  that  the  “MODEE  IS  READY  AND  UP  TO  DATE.” 
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Create  2D  view  of  the  Earth  with  an  orbit  trace 

•  Select  the  Graphics  option  from  the  Module  menu.  Available  Modules  and  Active  Modules 
lists  will  appear.  Scroll  down  the  Available  Modules  list  and  select  Earth.  An  Earth  object 
will  be  added  to  the  Active  Modules  list  and  a  set  of  Earth  Options  will  appear  in  the 
Environment  Window.  Select  “Outline  Detail”  options  Textured  and  Geographic  Bndys. 
Click  on  Display  and  the  Earth  will  appear  in  the  Window.  Convert  the  image  to  2D  by 
using  the  Viewport  menu  to  select  Projection  and  then  its  Two  D  option  (note  that  the  Three 
D  option  can  be  used  to  convert  it  back  to  a  3D  window). 

•  Scroll  down  the  Available  Modules  list  and  select  Satellite.  A  Satellite  object  will  be  added 
to  the  Active  Modules  list  and  a  set  of  Satellite  Options  will  appear.  Click  the  Satellite  list 
and  choose  DMSP  F8.  Under  “Reference  Erame”,  check  Inertial  (ECI)  and  uncheck 
Geocentric  (GEOC).  Click  in  the  Display  box  and  the  DMSP  orbit  will  appear. 

Create  a  Meteor  Impact  Science  Module  data  set 

•  Select  the  Science  option  from  the  Module  menu.  Available  Modules  and  Active  Modules 
lists  will  appear.  Scroll  through  the  Available  Modules  list  and  click  on  METEOR  IMPACT. 
A  SciMeteorImpact  object  will  be  added  to  the  Active  Modules  list  and  Meteor  Impact  Map 
options  will  appear  in  the  Environment  Window.  In  the  Show  Simulation  section,  the 
Sporadics  and  Flux  Only  options  should  be  selected. 

•  Within  the  optional  Storm  Simulations  section,  change  the  “Shower  Name”  to  delta- 
Aquarids(S)  (185-232).  With  the  Date/Duration  button  selected,  change  the  storm  duration 
by  setting  “Duration  (Hr)”=  6.00.  Click  the  Add  button  to  register  the  item  in  the  Storms  list. 

•  Select  the  Run/Update  option  in  the  Edit  menu  to  create  the  Meteor  Impact  data  set.  When 
completed,  the  Model  Status  box  will  indicate  that  the  “MODEE  IS  READY  AND  UP  TO 
DATE.” 

Create  a  2D  view  of  Meteor  Elux 

•  Select  the  Graphics  option  from  the  Module  menu.  Available  Modules  and  Active  Modules 
lists  will  appear.  Select  Coord  Slice  from  the  Available  Modules  list.  A  Coord  Slice  Object 
will  be  added  to  the  Active  Modules  list  and  a  set  of  Coord  Slice  Options  will  appear  in  the 
Environment  Window. 

•  Click  the  Data  button  and  select  Meteor  Flux  under  the  SciMeteorImpact  option.  Select 
Display  to  produce  a  fixed  radius  coordinate  slice  (corresponding  to  the  default  Cut  Plane 
CO). 

•  Click  the  Transparency  button  on  the  right  side  of  the  environment  window  and  a 
Transparency  slider  will  be  displayed  at  the  bottom  of  the  window.  Change  the  slider  value 
to  0.7  so  the  continent  outlines  can  be  seen.  Resize  the  window  so  it  resembles  the  following 
figure. 
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Create  a  3D  view  of  Meteor  Flux 

•  Use  the  Viewport  menu  to  seleet  Projection  and  then  its  Three  D  option.  Return  to  Available 
Modules  and  eliek  on  Isocontour.  An  IsoContour  Objeet  will  be  added  to  the  Active  Modules 
list  and  a  set  of  Isosurfaee  Options  will  appear. 

•  Cliek  the  Data  button  and  seleet  Meteor  Flux  under  the  SciMeteorImpact  option.  Cliek 
Display  and  move  the  Contour  Value  slider  to  0.859.  After  rotating  the  image,  Isosurfaees 
for  two  showers  from  different  direetions  will  appear  as  in  the  next  figure. 

Create  a  2D  Meteor  Sky  Map  Seienee  Module  data  set 

•  Seleet  the  Science  option  from  the  Module  menu.  Available  Modules  and  Active  Modules 
lists  will  appear.  Seroll  through  the  Available  Modules  list  and  eliek  on  METEOR  SKY 
MAPS.  A  SciMeteorMap  objeet  will  be  added  to  the  Active  Modules  list  and  Meteor  Ground 
Based  Sky  Map  and  Storm  Simulation  options  panels  will  appear  in  the  Environment 
Window.  The  Visual  and  Sporadics  options  should  already  be  seleeted. 
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•  Within  the  Storm  Simulations  section,  change  the  “Shower  Name”  to  delta- Aquarids(S) 
(185-232).  With  the  Date/Duration  button  selected,  change  the  storm  duration  by  setting 
“Duration  (Hr)”=  6.00.  Click  the  Add  button  to  register  the  item  in  the  Storms  list. 

•  Select  the  Run/Update  option  in  the  Edit  menu  to  create  the  Meteor  Impact  data  set.  When 
completed,  the  Model  Status  box  will  indicate  that  the  “MODEL  IS  READY  AND  UP  TO 
DATE.” 

Create  a  view  of  the  Meteor  Sky  Map 

•  Use  the  Window  menu  to  select  the  Create  2D  Viewport  option  and  a  new  2D  window  will 
appear.  Select  the  Graphics  option  from  the  Module  menu  and  Available  Modules  and  Active 
Modules  lists  will  appear.  From  the  Active  Modules  list,  highlight  Earth  and  click  Display. 

To  show  the  orbit  already  generated,  highlight  the  Satellite  entry  in  the  Active  Modules  list 
and  click  Display. 

•  Scroll  up  the  Available  Modules  list  and  select  Coord  Slice  and  a  Coord  Slice  entry  will 
appear  in  the  Active  Modules  list.  Click  the  Data  button  and  select  Count  under  the 
SciMeteorMap  option  and  click  Display.  After  using  the  Transparency  option  to  set  a 
transparency  value  of  0.75,  the  2D  plot  should  resemble  the  figure  below. 

Create  a  Meteor  Impact  Application  data  set. 

•  Select  the  Applications  option  from  the  Module  menu.  Available  Modules  and  Active 
Modules  lists  will  appear.  Scroll  through  the  Available  Modules  list  and  click  on  METEOR 
IMPACT  APP.  An  AppMeteorImpact  object  will  be  added  to  the  Active  Modules  and  a 
Meteor  Impact  Application  and  Storm  Simulation  options  panels  will  appear  in  the 
Environment  Window. 

•  Within  the  Storm  Simulations  section,  change  the  “Shower  Name”  to  delta- Aquarids(S) 
(185-232).  With  the  Date/Duration  button  selected,  change  the  storm  duration  by  setting 
“Duration  (Hr)”=  6.00.  Click  the  Add  button  to  register  the  item  in  the  Storms  list. 

•  Under  Meteor  Impact  Application  Options,  select  Setup  option  Satellite  to  see  satellite 
options.  With  the  From  File  element  type  option  selected,  click  on  the  File  button  and  a 
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window  will  appear  showing  the  eontents  of  $AFGS_HOME\models\data\EPHEMERIS. 
Cliek  on  the  file  icon  labeled  “dmsp.txt”  and  click  the  Open  button. 

•  A  list  of  DMSP  satellites  will  appear  in  the  Current  Element  File  list  in  the  middle  of  the 
window.  Select  DMSP  F8  and  edit  the  text  boxes  so  that  “T  start”  reads  “08/10/95 
12:00:00.00”  and  “E  stop”  reads  “08/17/95  12:00:00.00”.  Select  the  Run/Update  option  in 
the  Edit  menu  to  create  the  orbit  data  set.  When  completed,  the  Model  Status  box  will 
indicate  that  the  “MODEE  IS  READY  AND  UP  TO  DATE.” 

Display  a  Meteor  Impact  Application  data  set 

•  Use  the  Window  menu  to  select  the  Create  ID  Viewport  option  and  an  empty  1-D  graphics 
window  will  appear.  Note  that  the  Window  menu  options  Cascade  and  Tile  can  be  used  to 
access  the  existing  original  3-D  window. 

•  Select  the  Graphics  option  from  the  Module  menu.  Available  Modules  and  Active  Modules 
lists  will  appear.  Scroll  through  the  Available  Modules  list  and  click  on  Orbit  Probe.  An 
OrbitProbe  object  will  be  added  to  the  Active  Modules  list  and  an  Orbit  Probe  options  will 
appear  in  the  Environment  Window. 

•  Click  on  the  Path/Abscissa  button  and  select  the  Time  option  under  AppMeteorImpact 
(AppOrbit).  Click  on  the  Data/Ordinate  button  and  select  the  Meteor  Flux  option  under 
AppMeteorImpact.  Click  Display  and  a  plot  of  Meteor  Elux  vs.  Time  (along  the  DMSP 
orbit)  will  appear. 

•  In  the  X-Axis  Options  section,  change  the  information  in  the  Format  text  box  to  read  %1 .2f 
Click  in  any  other  text  box  to  register  the  change. 

•  Click  on  Orbit  Probe  in  the  Available  Modules  list  again.  A  second  OrbitProbe  object  will  be 
added  to  the  Active  Modules  list.  Click  on  the  Path/Abscissa  button  and  select  the  Time 
option  under  AppMeteorImpact.  Click  on  the  Data/Ordinate  button  and  select  the  Cum  Prob 
option  under  AppMeteorImpact.  Click  Display  and  a  plot  of  Cum  Probability  vs.  Time  (along 
the  DMSP  orbit)  will  appear. 

•  In  the  X-axis  Options  section,  uncheck  the  Enabled  option.  In  the  Y-axis  Options  section, 
select  Right.  The  ID  plot  should  now  resemble  the  figure  below,  which  shows  how  the 
shower  gradually  grows  and  wanes  in  intensity  over  the  seven  day  period.  The  optional  storm 
inserted  appears  as  a  spike  centered  on  the  global  time  of  12:00  on  day  225.  The  red  line 
represents  the  cumulative  probability  of  a  meteor  strike. 
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This  completes  the  Example  of  Meteor  Impact  Hazards. 
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14)  DMSP  Precipitating  Particles:  Data  vs.  Climatology 

The  following  example  demonstrates  the  use  of  the  DMSP  Data  Module,  the  DMSP  Graphies 

Module  and  the  Speetral  Viewport,  the  AURORA  Seienee  Module,  the  Satellite  Applieation 

Module  (SATEL-APP),  and  the  Orbit  Probe  Graphie  Module. 

Goal;  View  DMSP  preeipitating  eleetron  and  ion  data  using  energy  versus  time  speetral 
plots.  For  the  same  orbit,  ereate  a  ID  plot  eomparing  the  observed  eleetron  integral 
number  flux  along  a  DMSP  orbit  with  that  speeified  by  the  Hardy  Aurora  model. 

Start  an  AF-GEOSpaee  session  and  set  global  input  parameters 

•  Initiate  AF-GEOSpaee  via  the  Start  menu  (Start  >  Programs  >  AFGeospaee  >  AFGeospaee), 
the  desktop  ieon,  or  by  double-elieking  on  the  file  $AFGS_HOME\bin\AFGeospaee.bat. 
Maximize  the  AF-GEOSpaee  user  interfaee  window.  The  shell  windows  ean  be  minimized 
but  must  remain  open  for  AF-GEOSpaee  to  funetion. 

•  For  this  statie  run,  set  the  Global  Parameters  as  follows:  Start :Year=2003,  Day=94, 
UT=00:00.  The  Kp  index  and  other  parameters  eorresponding  to  the  speeified  date  and  time 
may  now  be  obtained  by  elieking  on  the  Globals:  Archive  option  to  the  right  of  the  time  input 
fields.  The  NGDC  arehived  values  of  these  parameters  are  then  automatieally  loaded 
{Kp=A3,  SSN=12,  FIO.  7=148.8,  &n&Ap=32). 

View  2-D  Energy  Speetra  Plots  of  DMSP  Data 

•  Seleet  the  Data  option  in  the  Module  menu.  Available  Modules  and  Active  Modules  lists  will 
appear.  Seleet  DMSP  from  the  Available  Modules  list.  An  AppDmsp  objeet  will  be  added  to 
\hQ  Active  Modules  list  and  a  set  of  DMSP  Options  will  appear  in  the  Environment  Window. 
Use  the  Satellite  seleetor  and  ehoose  All  (so  all  available  data  files  will  eventually  be 
displayed).  The  next  step  will  be  to  loeate  the  sample  DMSP  data  sets  supplied  with  the  AF- 
GEOSpaee  software. 

•  There  are  two  methods  of  aeeessing  DMSP  data:  (1)  If  $ AFGS_HOME\bin\AFGeospace.bat 
was  edited  before  this  AF-GEOSpaee  session  to  define  the  environment  variable  assoeiated 
with  the  DMSP  data,  then  a  seleetion  of  files  with  names  of  the  form  “j4fl303###”  appeared 
in  the  environment  window  during  the  previous  step  (see  note  in  seetion  “The  DMSP  Data 
Module”  of  this  doeument),  or  (2)  if  the  DMSP  environment  variable  was  not  previously  set, 
then  seleet  the  Browse  button  to  loeate  this  data.  The  Browse  button  will  eall  up  an  Open 
window.  Use  it  to  look  inside  the  direetory  $AFGS_FlOME\models\data\DMSP\2003, 
highlight  one  of  the  files,  seleet  the  Open  button,  and  five  file  names  of  the  form 
“j41303###”  will  appear  in  the  environment  window. 

•  The  five  entries  now  appearing  in  the  environment  window  represent  five  days  of  DMSP-F13 
data  for  days  92  to  96  of  year  2003.  Highlight  entry  j41 303094  and  ehange  the  Orbit  Number 
(1-15)  seleetor  to  read  3.  These  settings  will  proeess  data  from  the  SSJ/4  sensor  of  DMSP- 
F13  orbit  3  of  day  94  of  2003.  Use  the  Run/Update  option  of  the  Edit  menu  to  prepare  the 
seleeted  DMSP  data  for  viewing.  The  status  bar  at  the  bottom  of  the  environment  window 
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will  indicate  when  the  data  is  “Ready”.  Now  that  the  DMSP  data  is  ready,  we  next  need  to 
aeeess  the  DMSP  Graphies  Module. 

Select  the  Graphics  option  in  the  Module  menu.  Available  Modules  and  Active  Modules  lists 
will  appear.  Seleet  DMSP  from  the  Available  Modules  list.  A  2D  Plot  objeet  will  be  added 
to  the  Active  Modules  list  and  a  set  of  DMSP  Options  will  appear  in  the  Environment 
Window.  Now  use  the  Data  button  to  select  Counts  under  AppDmsp  option  and  notice  that 
the  Display  options  remains  inaetive.  This  is  beeause  the  display  of  2D  spectral  data  requires 
use  of  a  speeial  speetral  window. 

To  ereate  the  speetral  viewport  required,  use  the  Viewport  menu  and  seleet  the  Spectral  under 
the  Projection  option.  A  white  line  frame  will  appear  in  the  aetive  window  indicating  that  it 
has  been  eonverted  to  the  speetral  format.  Now  that  a  spectral  viewport  is  active,  the  Display 
option  also  becomes  active.  Seleet  Display  and  a  pair  of  2D  energy  spectrum  plots  will 
appear  with  ions  and  eleetrons  represented  in  the  upper  and  lower  panels,  respeetively.  The 
time  range  noted  on  the  horizontal  axis  represents  that  of  orbit  3  of  DMSP-F13  on  this  day. 
Resize  the  graphies  window  so  that  the  speetral  window  matehes  the  following  figure. 


(optional)  To  view  data  from  another  orbit,  return  to  the  Module  menu  and  seleet  the  Data 
option  again.  Available  Modules  and  Active  Modules  lists  will  appear.  With  the  AppDmsp 
option  highlighted  in  the  Active  Modules  list,  ehange  the  Orbit  Number  (1-15)  setting  from 
“3”  to  “4”  and  seleet  Run/Update  from  the  Edit  pulldown  menu  to  refresh  the  speetral 
viewport  display.  The  display  will  now  eontain  DMSP  speetral  data  from  orbit  4  of  day  94  of 
2003.  To  eontinue  this  exereise,  reset  Orbit  Number  (1-15)  baek  to  “3”  and  use  the 
Run/Update  option  of  the  Edit  menu  to  regain  the  display  above.  Now  use  the  Module  menu 
to  reseleet  Graphics  to  return  the  display  to  the  DMSP  graphies  window. 
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View  1-D  Plots  of  DMSP  Data  Parameters  as  a  Funetion  of  Energy  Channel  and  Time 

•  To  view  ID  quantities  available  with  the  DMSP  data  set,  use  the  Window  menu  and  seleet 
Create  ID  Viewport  and  a  new  ID  window  will  appear.  Use  the  Tile  option  of  the  Window 
menu  to  get  unobstructed  views  of  the  windows.  Use  the  ID  Plot  selector  and  choose  Data 
Probe  0  and  select  Display.  Move  the  Position  slider  to  read  0.150  and  the  horizontal  data 
probe  line  in  the  2D  window  will  be  sampling  an  electron  energy  channel  with  relatively  high 
fluxes.  The  counts  measured  along  this  probe  line  will  now  be  displayed  in  the  ID  window 
which  should  match  the  following  figure. 


Counts  /  Observation  DMSP  f1 3  094  2003 


2.58  2.80  3.01  3.22  3.43  3.65  3.86  4.07  4 


15.4  50.2  80.7  44.3  -12.4  -51.0  -82.1  -44.4  -19 

18.14  16.77  10.40  6.83  6.18  4.49  23.50  19.47  0.0 

UT  (  Hours  )  /  MLat  (  Deg  )/  Local  Time  (  Hours  ) 


•  Select  the  Y  Axis  option  above  the  Position  slider  and  the  data  probe  will  sample  all  energy 
channels  for  a  given  time.  With  the  Position  slider  set  equal  to  0.225,  the  ID  window  should 
now  match  the  following  figure. 


Counts  /  Observation 


DMSP  f1  3  094  2003 


19  17  15  13  10  8  6  4  2  0  18  16  14  12  9  7  5  3  1 

Energy  Channel  (  ) 
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•  To  view  one  of  the  eleetron  flux  quantities  integrated  over  all  energy  ehannels,  use  the  ID 
Plot  seleetor  to  choose  the  INF-E  (integrated  number  flux  for  electrons).  Change  the  Type 
from  Point  to  Line  and  move  the  Thickness  slider  to  the  far  left  and  the  ID  window  should 
resemble  the  following  figure.  Note  the  plot  units  are  actually  log(particles/cm  /sec/ster). 


Generate  and  View  the  DMSP-F13  Orbit  in  3D 

•  Select  the  Applications  option  in  the  Module  menu.  Available  Modules  and  Active  Modules 
lists  will  appear.  Scroll  down  the  Available  Modules  list  and  select  SATEL-APP  (satellite 
application).  An  AppSatel  object  will  be  added  to  the  Active  Modules  list  and  a  set  of 
Ephemeris  Data  options  will  appear  in  the  Environment  Window 

•  With  the  From  File  element  type  option  selected,  click  on  the  File  button  and  a  window  will 
appears  showing  the  contents  of  the  folder  $AEGS_HOME\models\data\EPHEMERIS. 

Click  on  the  file  icon  labeled  “orbits_for_exl4.txt”  and  click  the  Open  button.  A  list  of 
DMSP  satellites  will  appear  in  the  Current  Element  File  list  in  the  middle  of  the  window. 

•  Highlight  the  DMSP  FI 3  04/02/03  23:24:24. 00  entry  of  the  Current  Element  File  list  as  it 
contains  the  orbital  elements  appropriate  for  our  start  time.  The  satellite  name  and  the 
reference  time  associated  with  the  orbital  elements  are  given  in  boxes  below  the  list  box.  To 
view  the  orbital  elements  for  this  orbit  satellite,  click  on  the  Mean  element  type  button. 
Reselect  the  From  File  element  type  button  to  return  to  the  previous  view.  The  default  value 
for  the  start  time  (“T-Start”)  is  taken  from  the  global  values  at  the  top  of  the  Environment 
Window.  Whenever  a  SATEL-APP  module  is  run  in  “static”  mode,  a  1-day  interval  with  a 
60-second  time  step  is  used  by  default. 

•  Select  the  Run/Update  option  in  the  Edit  menu  to  create  the  orbit  data  set.  When  completed, 
the  Model  Status  box  will  indicate  that  the  “MODEL  IS  READY  AND  UP  TO  DATE.” 
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•  Use  the  Window  menu  and  select  Create  3D  Viewport  and  a  new  3D  window  will  appear. 
Select  the  Graphics  option  in  the  Module  menu.  Available  Modules  and  Active  Modules  lists 
will  appear.  Scroll  down  the  Available  Modules  list  and  select  Earth.  An  Earth  object  will 
be  added  to  the  Active  Modules  list  and  a  set  of  Earth  Options  will  appear  in  the  Environment 
Window.  Select  the  Lat/Lon  Grid  option  and  select  Display  and  the  Earth  will  appear  in  the 
active  3D  window. 

•  Now  scroll  down  the  Available  Modules  list  and  highlight  Satellite.  A  Satellite  object  will  be 
added  to  the  Active  Modules  list  and  a  set  of  Satellite  Options  will  appear  in  the  Environment 
Window.  Use  the  Satellite  selector  to  choose  DMSP-E13,  change  the  Reference  Frame 
selections  from  Geocentric  to  Inertial  (ECI)  and  select  Display,  and  the  DMSP  satellite  orbit 
will  appear  in  the  active  3D  window. 

Generate  and  View  a  3-D  Auroral  Science  Model  Data  Set  at  DMSP  Altitudes 

•  Select  the  Science  option  in  the  Module  menu.  Available  Modules  and  Active  Modules  lists 
will  appear.  Select  A  URORA  from  the  Available  Modules  list.  A  SciAurora  object  will  be 
added  to  the  Active  Modules  list  and  a  set  of  AURORA  Options  will  appear  in  the 
Environment  Window.  To  generate  model  output  on  a  3D  grid  that  includes  the  DMSP  orbit, 
select  the  Grid  Tool  option  of  the  Edit  menu  and  a  Grid  Tool  window  will  appear.  Within  the 
Rad,  GEOC  (Re)  section  change  NPoint  from  “1”  to  “3”,  set  Max  =  1.3,  and  click  OK.  Select 
the  Run/Update  option  in  the  Edit  menu  to  create  the  3-D  auroral  data  set.  When  completed, 
the  Model  Status  box  will  indicate  that  the  “MODEE  IS  READY  AND  UP  TO  DATE.” 

•  Select  Graphics  from  the  Modules  menu.  Available  Modules  and  Active  Modules  lists  will 
appear.  Select  Coord  Slice  from  the  Available  Modules  list  and  a  Coord  Slice  object  will  be 
added  to  the  Active  Modules  list  and  a  set  of  Coord  Slice  options  will  appear.  Use  the  Data 
button  to  select  Elec.  Number  Flux  under  the  SciAurora  option  and  click  Display.  The  model 
electron  number  flux  for  the  current  Kp  value  will  appear.  Move  the  Position  Value  slider  to 
approximately  0.410  to  place  the  coordinate  slide  near  the  DMSP  altitude.  Use  the  left/right 
mouse  buttons  to  rotate/resize  the  Earth  to  produce  a  picture  resembling  the  following  figure. 
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View  the  Auroral  Model  Output  Along  the  DMSP  Orbit  Path 

•  Click  on  the  existing  ID  Viewport  to  activate  it.  Scroll  down  the  Available  Modules  list  and 
select  Orbit  Probe.  An  Orbit  Probe  entry  will  appear  in  the  Active  Modules  lists  and  a  set  of 
Orbit  Probe  options  will  appear  in  the  environment  window.  Use  the  Path/Abscissa  button  to 
select  Time  under  the  AppSatel  option.  Use  the  Data/Ordinate  button  to  select  Elec.  Number 
Flux  under  the  SciAurora  option.  Select  Display  and  the  modeled  electron  number  flux  will 
appear  in  the  ID  window.  To  make  the  Orbit  Probe  time  axis  match  the  DMSP  orbit  3  time 
axis,  adjust  the  entries  in  the  X Axis  section  to  read  Mm  =  94.10764  and  Max  =  94.17846. 
Click  in  any  other  text  box  to  update  the  plot.  Uncheck  the  Enabled  box  in  the  X  Axis  section 
to  remove  the  redundant  horizontal  axis  scale  (note  that  one  was  decimal  days  and  the  other 
in  decimal  hours).  To  add  contrast,  select  the  Color  options  and  click  the  mouse  in  the  yellow 
portion  of  the  color  wheel  that  appears.  Move  the  Thickness  slider  slightly  to  the  right. 
Finally,  in  the  Y  Axis  section  of  the  Orbit  Probe  options,  set  Min  =  5.0  and  Max  =  10.0  and 
uncheck  the  Enabled  box  to  remove  the  redundant  vertical  scale.  With  these  adjustments,  the 
ID  window  should  resemble  the  final  figure. 
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In  this  last  figure,  we  can  see  that  the  Hardy  aurora  model,  driven  solely  by  the  Kp  index,  does  a 
good  job  of  specifying  electron  flux  levels  in  the  auroral  bands.  Remember  that  the  flux  is 
actually  plotted  on  a  log  scale. 

This  completes  the  Example  of  DMSP  Precipitating  Particles:  Data  Versus  Climatology. 
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15)  Magnetospheric  Specification  Model  (V2.5.1  Only,  Dynamic) 

The  following  example  demonstrates  the  use  of  the  Magnetospherie  Speeifieation  Model  (MSM) 

seienee  module,  the  Satellite  Applieation  Module  (SATEL-APP),  and  the  Global  Inputs, 

Coordinate  Sliee,  Orbit  Sliee,  and  Orbit  Probe  graphieal  modules,  and  a  variety  of  visualization 

tools. 

Goal:  View  the  3-D  evolution  of  plasma  sheet  eleetron  and  proton  fluxes  generated  by  the 
Magnetospherie  Speeifieation  Model  during  a  geomagnetieally  disturbed  period  and 
eompare  modeled  partiele  fluxes  along  a  geosynehronous  and  GPS  orbit  as  a  funetion 
of  time. 

Start  an  AF-GEOSpaee  session  and  set  global  input  parameters 

•  Initiate  AE-GEOSpaee  via  the  Start  menu  (Start  >  Programs  >  AFGeospaee  >  AFGeospaee), 
the  desktop  ieon,  or  by  double-elieking  on  the  file  $AFGS_HOME\bm\AFGeospaee.bat. 
Maximize  the  AF-GEOSpaee  user  interfaee  window.  The  shell  windows  ean  be  minimized 
but  must  remain  open  for  AF-GEOSpaee  to  funetion. 

•  Establish  a  dynamie  session  by  plaeing  a  eheek  mark  in  the  small  box  to  the  right  of  the 
Start:  UT  text  field  to  aetivate  the  End:  Year,  Day,  UT  text  fields.  Edit  the  Start  text  fields  so 
the  Year  =  1996,  Day  =  12,  and  UT=  18:00.  Edit  the  End  text  fields  so  that  Year  =  1996,  Day 
=  13,  and  UT=  18:00.  Use  the  Globals:  Archive  option  next  to  the  time  input  fields  to 
register  the  time  period  and  automatieally  load  parameters  from  the  NGDC  arehive. 

•  View  the  global  parameters  for  the  interval  seleeted  using  the  Globals  menu  (between  the 
Viewport  and  Help  menus  at  the  very  top  of  the  environment  window)  and  seleeting  the  Show 
option.  Note  that  for  all  modules  except  the  MSM,  the  global  parameters  ean  be  modified  by 
the  user  and  saved  for  use  during  the  eurrent  session.  While  the  MSM  aetually  aeeesses  its 
own  set  of  arehived  data  to  generate  its  inputs  (see  the  MSM  seienee  module  seetion),  the 
values  used  for  Kp,  SumKp,  SSN,  Dst,  and  EqE  (Equatorward  Edge)  will  mateh  those  now 
visible  in  the  Globals  popup  window.  Dismiss  the  Globals  window  using  the  Save  or  Cancel 
buttons  at  the  bottom. 

Display  plots  of  Kp,  Dst,  and  the  Equatorward  Edge  in  a  1-D  Window 

•  Seleet  the  Create  ID  Viewport  option  from  the  Window  menu  to  ereate  a  new  1-D  graphies 
window  to  display  the  geomagnetie  aetivity  indiees  Kp  and  Dst. 

•  Seleet  the  Graphics  option  in  the  Module  menu.  Available  Modules  and  Active  Modules  lists 
will  appear.  Seroll  down  the  Available  Modules  list  and  seleet  Global  Inputs.  A  Global 
Inputs  objeet  will  be  added  to  the  Active  Modules  list  and  a  set  of  Global  Inputs  options  will 
appear  in  the  Environment  Window. 

•  From  the  Value  input  seetion,  seleet  the  Kp  option  and  eheek  off  Display  to  produee  a  plot  of 
Kp  versus  time.  Move  the  Thickness  slider  slightly  to  the  right.  To  elean  up  this  1-D  plot, 
reset  the  X  Axis  text  field  so  that  Num  Tics  =  5  to  display  6  hour  (0.25  day)  intervals  and 
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uncheck  the  Grid  option  in  both  the  X  Axis  and  Y  Axis  seetions.  Reset  the  Y  Axis  Min  =  0.0, 
Max  =  9.0,  and  Num  Tics  =  4.  Click  in  any  other  text  field  to  update  the  plot.  Note  that  the 
Kp  index  ranges  between  1.3  and  5.0  for  this  30  hour  interval. 

•  Select  Global  Inputs  again  from  the  Available  Modules  list.  A  second  Global  Inputs  object 
will  be  added  to  the  Active  Modules  list  and  a  new  set  of  Global  Inputs  options  will  appear  in 
the  Environment  Window. 

•  From  the  Value  input  seetion,  select  the  DST  option  and  select  Display  to  plot  Dst  in  the 
existing  1-D  window.  Move  the  Thickness  slider  slightly  to  the  right.  Uneheck  the  Enable 
box  for  the  X  Axis  to  remove  the  redundant  time  labels,  select  the  Right  option  for  the  Y 
Axis,  and  uneheck  the  Grid  option  in  both  the  X  Axis  and  Y  Axis  sections.  Reset  the  Y  Axis 
Min  =  -100.0,  Max  =  +20.0,  and  Num  Tics  =  7.  Cliek  in  any  other  text  field  to  update  the  plot. 
Note  that  the  Dst  index  ranges  between  -88  nT  and  +8  nT  for  this  same  interval. 

•  Seleet  Global  Inputs  again  from  the  Available  Modules  list.  A  third  Global  Inputs  object  will 
be  added  to  the  Active  Modules  list  and  a  new  set  of  Global  Inputs  options  will  appear  in  the 
Environment  Window. 

•  From  the  Value  input  section,  select  the  EqEdge  option  and  seleet  Display  to  plot  Eq  Edge  in 
the  existing  1-D  window.  Move  the  Thickness  slider  slightly  to  the  right.  Uncheek  the  Enable 
box  for  the  X  Axis  to  remove  the  redundant  time  labels  and  uneheck  the  Grid  option  in  the  Y 
Axis  sections.  Reset  the  Y  Axis  Min  =  54.0  and  Max  =  66.0.  Click  in  any  other  text  field  to 
update  the  plot.  Note  that  the  equatorward  edge  of  the  diffuse  aurora  at  midnight  (Eq  Edge), 
measured  in  degrees  latitude,  is  an  indieator  of  magnetic  field  line  stretehing  in  the 
magnetotail.  Typically,  the  nightside  magnetic  field  becomes  more  stretched  (i.e.,  Eq  Edge 
decreases)  as  the  inner  magnetospheric  magnetic  field  becomes  more  inflated  (i.e.,  as  Dst 
deereases)  and  thus  Dst  and  Eq  Edge  profiles  often  resemble  eaeh  other.  The  Eq  Edge  also 
has  an  inverse  relationship  with  Kp  whieh  is  not  very  evident  in  this  example. 

•  Seroll  up  the  Available  Modules  list  and  seleet  Annotation.  An  Annotation  objeet  will  be 
added  to  the  Active  Modules  list  and  a  set  of  Annotation  Options  will  appear  in  the 
Environment  Window.  Check  the  Show  Date  and  the  Display  boxes  and  use  the  X and  Y 
Position  sliders  to  move  the  annotation  to  the  top.  The  ID  window  should  resemble  the  next 
figure. 

Run  an  MSM  Simulation  and  Create  Eleetron  and  Proton  Data  Sets, 

•  Seleet  the  Science  option  in  the  Module  menu.  Available  Modules  and  Active  Modules  lists 
will  appear.  Seroll  down  the  Available  Modules  list  and  seleet  MSM  (Magnetospheric 
Specification  Model).  An  MSM  object  will  be  added  to  the  Active  Modules  list  and  a  set  of 
MSM  Options  will  appear  in  the  Environment  Window 

•  While  not  a  model  input,  a  descriptive  phrase  (maximum  of  68  characters)  ean  be  placed 
in  the  Run  ID  text  box  to  label  the  simulation  run.  It  can  serve  as  a  useful  reminder  of  the 
global  time  interval  settings,  for  example,  when  the  science  module  is  saved  to  be 
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accessed  in  the  future.  Edit  the  Run  ID  text  box  to  read  “MSM  -  Example  15,  1996  Day 
12  18:00 -Day  13  18:00”. 


•  Eor  the  Kp  Mode,  select  the  Full  MSM  (Kp  to  fill  gaps)  option  and  an  MSM:  Use  Input 
popup  window  will  appear.  Plaee  cheek  marks  next  to  DST,  EQ.  Edge,  and  PCP  and 
leave  the  default  No  IMF,  XIPATT  selection.  Click  the  Oif  button  and  the  Dst  index,  the 
equatorward  edge  boundary  of  the  diffuse  aurora,  and  the  polar  cap  potential  drop  will  be 
used  as  direet  inputs  to  the  model.  All  other  required  model  inputs  will  either  be  default 
values  or  be  derived  automatieally  using  Kp-proxy  relationships  internal  to  the  MSM 
seience  eode.  In  this  ease,  the  default  symmetric  ionospheric  electric  potential  pattern 
(otherwise  determined  using  either  the  IMFBY,  IMFBZ  or  XIPATT  inputs)  will  be 
assumed  and  the  magnetopause  stand-off  distance  (calculated  internally  by  the  model 
using  SWDEN  and  SWVEL)  will  be  calculated  from  Kp. 


•  Eeave  the  Run  Prefix  text  box  reading  “x”  (used  as  a  file  name  prefix  internally  by  the 
MSM)  and  place  a  cheek  mark  next  to  the  H+  option  below  (e-  should  already  be 
ehecked)  so  that  both  eleetrons  and  protons  will  be  traeked  by  the  simulation.  The  Energy 
Range  (keV)  and  L-Shell  Range  options  can  remain  unehanged  as  the  default  settings  will 
result  in  the  maximum  energy  range  of  partieles  to  be  followed.  Leave  the  Run  Mode  set 
as  Base/Map  so  that  the  base  MSM  simulation  and  the  mapping  proeedure  will  be 
exeeuted  in  sequence.  The  Check  Modes  button  will  bring  up  a  window  with  short  notes 
applieable  to  the  MSM  run  associated  with  the  entered  Run  Prefix,  e.g.,  it  will  indieate  if 
a  run  with  that  prefix  already  exists 


•  The  partiele  speeies/energy  pairs  to  be  mapped  onto  the  3-D  grid  (to  be  defined  in  the 
next  step  using  the  Grid  Tool  option  of  the  Edit  menu)  are  seleeted  using  the  Set  Map 
Energies  button.  Cliek  this  button  and  an  MSM  Energies  window  appears  with  active 
columns  for  electron  and  proton  energies  (beeause  e-  and  H+  were  seleeted  in  the  main 
MSM  environment  window).  Leave  the  default  30  keV  entry  for  the  “0”  entry  in  the  e- 
Energy  (keV)  eolumn  and  edit  the  “0”  entry  in  the  H+  Energy  (keV)  column  to  also  read 
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30  keV.  Click  the  Update  and  Done  buttons  to  register  the  selection  and  close  the 
window. 

Seleet  the  Grid  Tool  option  of  the  Edit  menu  and  note  that  the  default  settings  extend  the 
grid  out  to  beyond  14  Re  which  is  the  largest  magnetopause  stand-off  distanee  used  by 
the  geomagnetic  field  model  employed  by  the  MSM.  The  mapping  proeedure  will 
attempt  to  extract  particle  fluxes  from  the  simulation  at  the  energies  seleeted  in  the 
previous  step  for  eaeh  grid  point.  Leave  the  default  setting  and  elose  the  Grid  Tool 
window  using  the  OK  button.  In  the  future,  if  the  user  is  interested  in  limiting  the  volume 
proeessed  then  the  grid  ean  be  adjusted.  For  example,  if  geosynehronous  orbit  is  the  only 
region  of  interest,  then  the  Grid  Tool  System  could  be  ehanged  to  GEOC  and  the  Latitude 
range  eould  be  limited  to  values  eloser  to  the  equator.  Note  that  the  mapping  proeedure 
speed  increases  as  the  grid  volume  gets  smaller. 

One  additional  step  is  required  in  order  to  plot  magnetic  field  quantities  and  the 
speeies/energy  pairs  seleeted  two  steps  above.  Seleet  the  Dynamic  Tool  option  of  the  Edit 
menu  to  get  the  Dynamic  Tool  popup  window  to  appear.  Beeause  we  filled  in  the  “0” 
entries  for  both  the  e-  and  H+  Energy  (keV)  eolumns  of  the  MSM  Energies  window 
earlier,  we  must  also  eheek  the  eorresponding  write -to-file  quantities,  i.e.,  leave  the  eheek 
next  to  eEnergyO  and  plaee  a  eheek  next  to  the  hEnergyO  options.  Cheek  the  Bx,  By,  Bz, 
and  Btot  options  also  if  you  like  to  view  magnetie  field  values  generated  by  the  MSM 
magnetic  field  model  [Hilmer  and  Voigt,  1995].  Note  that  with  the  900  seeond  (15- 
minute)  native  time-step  of  the  MSM,  97  simulation  steps  will  be  ealculated  to  eover  the 
24  hour  period.  To  reduee  running  time,  set  the  Time  Step  (sec)  =  1800  to  map  the  output 
only  onee  every  30  minutes.  Cliek  the  Update  List  button  to  fix  the  seleetions  and  the 
Done  button  to  elose  the  window. 

Seleet  the  Run/Update  option  in  the  Edit  menu  to  ereate  the  partiele  flux  and  magnetie  field 
data  set.  Note  that  this  run  will  take  several  minutes.  While  the  Process  View  window  does 
not  indieate  progress  until  the  mapping  proeedure  begins,  the  aetually  running  of  the  MSM 
simulation  can  be  followed  by  looking  at  one  of  the  DOS  exeeution  windows.  When 
eompleted,  the  Model  Status  box  will  indieate  that  the  “MODEE  IS  READY  AND  UP  TO 
DATE.” 

As  mentioned  above,  the  inputs  selected  to  drive  this  run  (default  Kp  plus  optional 
parameters  DST,  EQ.  Edge,  and  PGP)  are  used  by  the  MSM  to  produee  the  eomplete  set  of 
parameters  needed  at  the  15 -minute  simulation  mark  times.  To  view  these  parameters  cliek 
on  the  Show  MSM  Inputs  button  at  the  bottom  of  the  MSM  environment  window.  The  values 
for  Dst,  EqE,  and  PCP  are  all  determined  via  interpolation  and  the  magnetopause  standoff 
distanee  (Std)  is  derived  via  a  Kp  relationship.  If  parameters  IMFBY,  IMFBZ  or  SWDEN, 
SWVEL  had  been  seleeted  above,  then  their  interpolated  values  would  also  be  listed  and  the 
Std  value  would  have  been  derived  using  SWVel  and  SWDen  values.  The  eolumn  labeled 
“P”  refers  to  the  polar  cap  potential  pattern  type  used  and  in  this  ease  the  value  of  2  indieates 
a  dawn-dusk  symmetrie  eleetrie  field  pattern.  If  the  user  is  interested  in  seeing  the  raw  inputs 
used  to  ereate  the  Show  Inputs  table,  they  ean  examined  some  of  the  files  in  the  SeiMSM# 
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folder  created  in  the  user’s  scratch  space  (see  details  in  the  Show  Inputs  portion  of  the  MSM 
Science  Module  section). 


Display  the  Earth,  SM  Axes,  and  Sun  Vector  in  the  GSM  Coordinate  Reference  Frame, 

•  Click  on  the  original  blank  3-D  graphics  window  to  activate  it.  Select  the  Graphics  option  in 
the  Modules  menu  and  Available  Modules  and  Active  Modules  lists  will  appear.  Select  Earth 
from  the  Available  Modules  list.  An  Earth  object  will  be  added  to  the  Active  Modules  list  and 
a  set  of  Earth  Options  will  appear  in  the  bottom  of  the  Environment  Window.  Select  the  Grid 
Option  Lat/Lon  Grid  to  add  the  geographic  markings.  Click  in  the  Display  box  to  place  the 
Earth  in  the  3D  Window.  The  left  and  right  mouse  buttons  can  be  used  to  rotate  and  scale  the 
Earth  image  while  the  cursor  is  in  the  Window. 

•  Highlight  the  Annotation  entry  in  the  Active  Modules  list  on  the  right  side  of  the  environment 
window  and  check  Display  to  place  the  existing  time/date  annotation  in  the  3-D  window. 

•  Select  Axes  from  the  Available  Modules  list  and  an  Axes  object  will  be  added  to  the  Active 
Modules  list.  Change  the  Axes  Frame  selection  from  the  default  GEOC  to  SM  and  also  select 
the  Sun  Vector  option.  The  Solar  Magnetic  (SM)  coordinate  system  is  useful  because  the 
Earth’s  magnetic  dipole  is  aligned  with  the  SM  z-axis  (see  the  Grid  Tool  section  of  the 
documentation  for  coordinate  system  definitions).  Click  the  Display  box  and  a  set  of 
orthogonal  axes  in  the  SM  coordinate  system  (red,  green,  blue)  will  appear.  Notice  that  the 
North  magnetic  pole  (blue  axis)  is  located  about  1 1  degrees  from  the  geographic  North  Pole 
near  Greenland.  The  yellow  axis  is  the  sun  vector. 

•  From  the  Viewport  menu,  select  View  Position  and  then  the  GSM  option.  This  will  keep  the 
3-D  graphics  window  fixed  in  the  GSM  frame  during  animation  (matching  the  MSM 
simulation  Grid  Tool  coordinate  frame),  i.e.,  the  Earth  will  rotate  and  the  sun  vector  (defined 
to  be  coincident  with  the  GSM  x-axis)  will  remain  fixed.  From  the  Viewport  menu,  remove 
the  check  mark  from  the  Perspective  setting.  Use  the  left  mouse  button  to  orient  the  Earth 
such  that  the  sun  vector  (yellow)  points  to  the  left  and  the  SM  y-axis  (green)  points  directly 
out  of  the  screen. 

•  Select  the  Animate  Tool  from  the  Edit  menu  and  the  Animate  window  will  appear.  Reset  the 
Time  Step  (Sec)  field  to  1 800  and  click  the  Update  button.  Use  the  left-right  slider  arrows  to 
change  the  time  by  1800  second  steps  and  note  how  the  Earth’s  magnetic  dipole  (coincident 
with  the  SM  z-axis;  blue)  wobbles  in  this  GSM  coordinate  frame.  During  this  early  time  of 
year,  the  northern  dipole  is  always  tilted  away  from  the  Sun.  In  the  1  -D  window,  the 
changing  time  can  be  seen  as  the  annotation  changes  and  marks  move  along  the  Kp,  Dst,  and 
Eq  Edge  parameter  lines.  Return  the  Animate  window  slider  to  the  far  left  and  close  the 
window  with  the  Done  button. 

View  an  Animation  of  Electron  Fluxes  in  the  GSM  Noon-Midnight  Plane 

•  To  display  the  electron  particle  flux  values  stored  on  our  GSM  grid,  select  Coord  Slice  from 
the  Available  Modules  list.  A  Coord  Slice  object  appears  in  the  Active  Modules  list  and  a  set 
of  Coordslice  Options  appear  in  the  Environment  Window.  Click  on  the  Data  button,  and 
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under  the  SciMsmO  option,  choose  E-  FluxO  30.0,  and  click  Display.  To  get  a  coordinate  slice 
aligned  with  the  GSM  X-Z  plane  select  Cut  Plane  C2.  Remember  that  the  right  mouse  button 
can  be  used  to  resize  the  display  contents.  Select  the  Data  Map  option  and  reset  Data  Min  = 
3.00  and  Data  Max  =  7.00  at  the  bottom  of  the  environment  window. 

To  view  a  similar  coordinate  slice  on  the  sunward  side  of  the  Earth,  repeat  the  last  step  to 
create  another  coordinate  slice  and  then  move  the  Position  Value  slider  to  0.500.  The  3-D 
graphic  window  should  resemble  the  following  figure. 


Open  the  Animate  Tool  in  the  Edit  menu  and  view  the  MSM  sequence  using  the  Animate 
switch  and  the  slider  arrow  in  the  Animate  Window.  Note  that  some  of  the  peak  fluxes  occur 
near  and  the  Dst  minimum  during  this  event.  The  30  keV  electrons  remain  trapped  on 
magnetic  field  lines  which  are  fairly  dipolar  near  the  Earth,  thus  the  electron  distributions 
stay  approximately  aligned  with  the  SM  axis  plotted.  The  peak  fluxes  near  the  SM  equatorial 
plane  designate  the  center  of  the  magnetospheric  plasma  sheet.  The  motion  of  this  plasma 
sheet  is  discussed  in  relation  to  magnetic  field  topology  in  Example  3  in  this  document.  The 
distribution  of  30  keV  protons  is  similar  but  fluxes  are  lower  and  not  as  broadly  distributed. 
The  next  (optional)  step  will  produce  a  similar  picture  of  proton  fluxes. 

(Optional  step)  To  obtain  the  same  view  of  the  proton  flux  values  stored  on  our  GSM  grid, 
highlight  each  Coord  Slice  entry  in  the  Active  Modules  list,  click  on  the  Data  button,  and 
under  the  SciMsmO  option,  choose  //+  FluxO  30.0.  For  each  Coord  Slice  entry  you  must 
again  select  the  Data  Map  option  and  reset  Data  Min  =  3.00  and  Data  Max  =  7.00  at  the 
bottom  of  the  environment  window.  If  the  Data  Map  option  is  already  selected  (and  its 
options  are  not  visible),  then  select  any  other  option  and  reselect  Data  Map  to  view  them. 
The  3-D  graphic  window  would  now  resemble  the  following  figure. 
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Create  and  Display  a  GEO  Orbit 

•  Select  the  Applications  option  in  the  Module  menu.  Available  Modules  and  Active  Modules 
lists  will  appear.  Scroll  down  the  Available  Modules  list  and  select  SATEL-APP.  An 
AppSatel  object  will  be  added  to  the  Active  Modules  list  and  a  set  of  Ephemeris  Data  options 
will  appear  in  the  Environment  Window 

•  With  the  From  File  element  type  option  selected,  click  on  the  File  button  and  a  window  will 
appears  showing  the  contents  of  the  folder  $AFGS_HOME\models\data\EPHEMERIS. 

Click  on  the  file  icon  labeled  “goes.txt”  and  click  the  Open  button.  A  list  of  GOES  satellites 
will  appear  in  the  Current  Element  File  list  in  the  middle  of  the  window.  Highlight  the 
GOES  7  entry  and  then  use  the  Run/Update  option  in  the  Edit  menu  to  create  the  orbit  data 
set.  When  completed,  the  Model  Status  box  will  indicate  that  the  “MODEL  IS  READY 
AND  UP  TO  DATE.” 

View  Electron  Fluxes  in  the  GEO  Orbit  Plane 

•  Select  the  Graphics  option  in  the  Module  menu  and  Available  Modules  and  Active  Modules 
lists  will  reappear.  Scroll  down  the  Available  Modules  list,  select  Satellite,  and  Satellite 
Options  will  appear.  Pick  the  GOES  7  entry  of  the  Satellite  selector,  check  Display,  and  the 
GOES  7  satellite  will  appear  in  the  3-D  window.  Under  Reference  Frame,  uncheck 
Geocentric  and  then  check  Inertial  (ECI)  so  that  a  trace  of  the  entire  orbit  path  is  visible.  Use 
the  Color  option  to  change  the  orbit  to  the  color  blue  by  clicking  directly  on  the  blue  area  of 
the  color  wheel  that  appears  With  the  left  mouse  button  depressed,  move  the  mouse  down  to 
bring  the  north  geographic  pole  and  the  entire  geosynchronous  orbit  path  in  view  so  that  the 
3-D  window  now  resembles  the  following  figure.  Note  that  highlighting  one  of  the  active 
Coord  Slice  entries  will  refresh  the  color  bar  labels. 
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•  To  view  the  electron  flux  in  the  geosynchronous  orbit  plane,  scroll  up  the  Available 
Modules  list,  select  the  Orbit  Slice  option  and  a  set  of  Orbit  Slice  options  appear.  Select 
GOES  7  from  the  Satellite  list.  Click  on  the  Data  button  and  choose  E-  FluxO  30.0  under 
the  SciMsmO  option,  select  the  Orbit  Plane  option  P3,  and  click  Display.  Use  the  Data 
Map  option  to  set  Data  Min  =  3.00  and  Data  Max  =  7.00  to  match  the  existing  coordinate 
slices  displayed.  Use  the  Animate  Tool  from  the  Edit  menu  to  toggle  the  time  step  away 
and  back  to  the  1 1  ;00  mark  so  that  the  Orbit  Plane  fluxes  are  properly  set.  The  3-D 
window  should  now  resemble  the  following  figure. 


•  Use  the  Animate  Tool  of  the  Edit  menu  to  survey  the  development  of  the  30  keV  electron 
flux  in  the  geosynchronous  orbit  plane.  (Note  that  because  we  fixed  the  view  in  the  GSM 
coordinate  frame  earlier,  the  geosynchronous  orbit  will  appear  to  wobble  slightly.  Use  the 
View  Position  option  of  the  Viewport  menu  and  select  the  GEI  option  to  fix  geographic  based 
orbit  in  the  window  during  animation  while  keeping  the  sun  vector  pointing  to  the  left.)  Note 
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that  the  initial  MSM  particle  fluxes  are  symmetric  about  the  Earth  and  that  it  takes  several 
hours  for  realistic  distributions  to  become  established.  After  the  artificial  effects  of  the  initial 
condition  disappear,  it  is  evident  that  the  modeled  source  for  electrons  is  on  the  night  side  of 
magnetosphere  and  that  the  electrons  drift  earthward  from  the  magnetotail  and  then  move 
eastward  to  wrap  around  to  the  dayside.  The  size  of  the  simulation  region  changes  as  the 
magnetopause  standoff  distance  changes  (in  this  case  following  Kp)  to  decrease  in  size 
during  the  middle  period  then  increase  again  toward  the  end  of  the  interval.  With  the  Orbit 
Slice  entry  highlighted  in  the  Active  Modules  list  and  change  the  Data  selection  to  H+  FluxO 
30.0  and  view  an  animation  of  the  protons.  Use  the  Data  Map  option  to  ser  the  Data  Min  = 

3.0  and  the  Data  Max  =  7.0.  Although  not  apparent  in  this  view,  the  proton  distribution  is 
also  initially  symmetric  like  the  electrons,  but  protons  drift  westward  when  they  reach  the 
inner  magnetosphere  from  the  tail.  (To  properly  view  the  symmetric  initial  condition,  one 
should  really  view  a  CoordSlice  using  Cut  Plane  Cl  with  Position  Value  =  0.5.) 

Create  and  Display  a  GPS  Orbit 

•  Select  the  Applications  option  in  the  Module  menu.  Available  Modules  and  Active  Modules 
lists  will  appear.  Scroll  down  the  Available  Modules  list  and  select  SATEL-APP.  An 
APPSatel  object  will  be  added  to  the  Active  Modules  list  and  a  set  of  Ephemeris  Data  options 
will  appear  in  the  Environment  Window 

•  Select  the  From  File  element  type  option  and  click  on  the  File  button  and  a  window  will 
appears  showing  the  contents  of  the  folder  $AEGS_HOME\models\data\EPHEMERIS. 

Click  on  the  file  icon  labeled  “gps.txt”  and  click  the  Open  button.  A  list  of  GPS  satellites  will 
appear  in  the  Current  Element  File  list  in  the  middle  of  the  window.  Select  GPS  BII-08. 
Select  the  Run/Update  option  in  the  Edit  menu  to  create  the  orbit  data  set.  When  completed, 
the  Model  Status  box  will  indicate  that  the  “MODEE  IS  READY  AND  UP  TO  DATE.” 

•  Select  the  Graphics  option  in  the  Module  menu  and  the  Available  Modules  and  Active 
Modules  lists  will  reappear.  Scroll  down  the  Available  Modules,  select  Satellite,  and  Satellite 
Options  will  appear.  Pick  the  GPS  BII-08  entry  of  the  Satellite  selector,  and  then  check 
Display  and  the  GPS  satellite  will  appear  in  the  3-D  window.  Under  Reference  Frame, 
uncheck  Geocentric  and  then  check  Inertial  (ECI)  so  that  a  trace  of  the  entire  orbit  path  is 
visible. 

Compare  Electron  Eluxes  Along  a  GEO  and  GPS  Orbit 

•  Select  the  Create  ID  Viewport  option  from  the  Window  menu  to  create  a  new  1-D  graphics 
window.  Remember  that  the  Window  menu  options  Tile  and  Cascade  can  be  used  to  manage 
window  viewing. 

•  Scroll  up  the  Available  Modules  list  and  select  Orbit  Probe.  An  Orbit  Probe  object  will  be 
added  to  the  Active  Modules  list  and  a  set  of  Orbit  Probe  options  will  appear  in  the 
Environment  Window. 

•  Select  the  Time  option  of  the  first  AppSatel  entry  using  the  Path/Abscissa  button.  Now  select 
the  E-  FluxO  30.0  option  of  the  SciMsm  entry  using  the  Data/Ordinate  button  and  click 
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Display  and  a  plot  of  GOES  7  electron  flux  vs.  time  will  appear  in  the  new  1-D  window. 
Reset  the  Y Axis  values  Min  =  3.5  and  Y Axis  Max  =  6.5.  Move  the  Thickness  slider  to  the 
right  slightly  to  thicken  the  line.  Click  in  any  other  text  box  to  update  labels.  If  necessary,  use 
the  Color  option  and  click  in  the  center  of  the  color  wheel  that  appears  to  change  the  flux 
trace  white. 

•  To  generate  a  similar  plot  for  the  GPS  satellite,  repeat  the  procedure  in  the  previous  two 
bullets  except  this  time  select  the  Time  option  of  the  second  AppSatel  entry  using  the 
Path/Abscissa  button.  After  resetting  the  Y Axis  Min  =  3.5  and  Max  =6.5  so  that  the  Y  Axis 
labels  match  those  of  the  GOES  plot,  remove  the  redundant  axes  labels  by  removing  the 
check  mark  in  the  two  Enable  boxes  in  both  the  X  Axis  and  Y  Axis  sections.  Use  the  Color 
option  to  change  the  trace  to  red  and  increase  the  line  thickness  slightly.  The  new  1-D 
window  should  resemble  the  following  figure. 


•  Use  the  Animate  Tool  of  the  Edit  menu  to  survey  the  time  history  of  the  30  keV  electron  flux 
in  the  GOES  and  GPS  satellites.  As  indicated  in  the  1-D  window,  the  3-D  window  also 
shows  that  the  GPS  satellite  at  4.2  Re  traverses  the  plasma  sheet  twice  an  orbit  and  actually 
samples  higher  fluxes  than  the  GOES  satellite  which  remains  within  the  plasma  sheet  the 
entire  simulation  at  6.62  Re. 

This  completes  the  Example  of  the  Magnetospheric  Specification  Model. 
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16)  Ionospheric  Plasma  Bubbles:  Flux  Tube  Specification 

The  following  example  demonstrates  the  use  of  the  BFOOTPRINT  Applieation  Module,  the 

BFIELD  Applieation  Module,  and  a  variety  of  visualization  tools. 

Goal:  lonospherie  plasma  bubbles  are  depletions  in  ionospherie  eleetron  density  whieh  are 
deteetable  by  instruments  on  the  DMSP  and  ROCSAT  satellites.  If  satellites  on 
different  orbits  deteet  depletions  in  a  partieular  region  at  nearly  the  same  time,  it  is 
possible  that  they  may  be  sampling  parts  of  a  larger  plasma  bubble  strueture.  The  goal 
of  this  example  is  to  estimate  the  spatial  extent  of  an  ionospherie  plasma  bubble 
measured  by  multiple  spaeeeraft  by  mapping  geomagnetie  field  lines  from  loeations 
within  the  bubble.  The  volume  defined  by  this  eolleetion  of  field  lines  will  be  used  to 
estimate  the  full  extent  of  the  plasma  depletion. 

Start  an  AF-GEOSpaee  session  and  set  global  input  parameters 

•  Initiate  AE-GEOSpaee  via  the  Start  menu  (Start  >  Programs  >  AEGeospaee  >  AEGeospaee), 
the  desktop  ieon,  or  by  double-elieking  on  the  file  $APGS_HOME\bin\APGeospaee.bat. 
Maximize  the  AF-GEOSpaee  user  interfaee  window.  The  shell  windows  ean  be  minimized 
but  must  remain  open  for  AF-GEOSpaee  to  funetion. 

•  Eor  this  statie  run,  set  the  Global  Parameters  as  follows:  Start :Year=2000,  Day=62, 
UT=\3:\5.  Cliek  on  the  Globals:  Archive  option  to  the  right  of  the  time  input  fields  to  load 
the  arehived  NGDC  parameter  values  (Kp=2,  SSN=\30,  FIO.  7=209.6,  and  Ap=l). 

Create  the  DMSP  and  ROCSAT  orbit  data  sets 

•  Seleet  the  Applications  option  in  the  Module  menu.  Available  Modules  and  Active  Modules 
lists  will  appear. 

•  Seleet  BFOOTPRINT-APP  from  the  Available  Modules  list.  An  APPBFootprint  objeet  will 
be  added  to  the  Active  Modules  list  and  a  set  of  B-Eield  Eootprint  Applieation  options  will 
appear  in  the  Environment  Window 

•  Eor  eaeh  satellite  that  eneountered  a  plasma  bubble,  we  will  traee  field  lines  from  three 
loeations  along  the  portion  of  the  orbit  path  interseeting  the  bubble,  i.e.,  from  the  plasma 
bubble  entry  and  exit  points  and  from  one  point  between  the  two.  To  aeeomplish  this,  make 
the  following  ehanges: 

-  While  the  Setup:  Footprint  Model  option  is  seleeted,  set  the  Foot  Line  Inputs  to  be  From 
Satellite,  ehange  the  Satellite  Orbit  Steps  to  “3”,  and  seleet  the  Internal  B -field  option 
IGRF(1 945-2010). 

-  Seleet  the  Setup:  Satellite  option  and  Ephemeris  Data  options  will  appear.  Eeave  the  From 
File  option  seleeted  and  eliek  the  File  button  and  a  window  will  appear  showing  the  eontents 
of  the  folder  $AEGS_HOME\models\data\EPHEMERIS.  Cliek  on  the  file  ieon  labeled 
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“orbits_for_exl6.txt”  and  click  the  Open  button.  A  list  of  three  satellites  will  appear  in  the 
Current  Element  File  list  in  the  middle  of  the  window. 

•  Seleet  the  DMSP-F12  entry  and  the  satellite  name  and  the  referenee  time  assoeiated  with  the 
orbital  elements  will  appear  in  boxes  below  the  list  box.  DMSP-F12  measured  a  plasma 
depletion  for  4  minutes.  To  generate  the  orbit  for  this  interval,  edit  the  text  boxes  sueh  that 

“03/02/00  12:50:00.0”,  T  stop  =  “03/02/00  12:54:00.0”,  and  Time  Step(s)  =  “10”. 
Seleet  the  Run/Update  option  in  the  Edit  menu  to  ereate  the  orbit  data  set.  When  completed, 
the  Model  Status  box  will  indieate  that  the  “MODEL  IS  READY  AND  UP  TO  DATE.” 

•  Proeess  the  next  two  satellites  of  the  Current  Element  File  list  in  the  same  manner  by 
repeating  the  instruetions  in  the  last  three  bullets  twiee  but  ehanging  the  ehoiees  used  in  the 
last  bullet  eaeh  time.  This  will  result  in  three  AppBFootprint  items  in  the  Active  Modules  list. 

-  Eor  DMSP-P15,  whieh  passed  thru  a  plasma  depletion  for  six  minutes,  edit  the  text  boxes 
sueh  that  T_start  =  “03/02/00  13:28:30.0”,  T  stop  =  “03/02/00  13:34:30.0”,  and  Time  Step(s) 
=  “10”. 


-  Eor  ROCSAT,  whieh  passed  thru  a  plasma  depletion  for  more  than  a  minute,  edit  the  text 
boxes  sueh  that  T_start  =  “03/02/00  13:14:25.0”,  T  stop  =  “03/02/00  13:15:35.0”,  and  Time 
Step(s)  =  “10”. 

Display  the  Earth  and  Time/Date  Annotation 

•  Seleet  the  Graphics  option  in  the  Module  menu.  Available  Modules  and  Active  Modules  lists 
will  appear.  Seroll  down  the  Available  Modules  list  and  seleet  Earth.  An  Earth  object  will 
be  added  to  the  Active  Modules  list  and  a  set  of  Earth  Options  will  appear  in  the  Environment 
Window.  Seleet  CGM  Grid  from  the  Grid  Options  seetion  and  select  Display  and  an  Earth 
with  corrected  geomagnetie  eoordinate  grid  will  appear.  Use  the  Viewport  pulldown  menu  to 
deactivate  (uncheek)  the  Show  Color  Bar  and  Perspective  options. 

•  Seroll  up  the  Available  Modules  list  and  seleet  Annotation.  An  Annotation  objeet  will  be 
added  to  the  Active  Modules  list.  Select  the  Show  Date  option  and  eliek  Display.  Adjust  the  X 
and  Y  Position  sliders  so  that  the  annotation  appears  in  the  upper  left  of  the  window. 

Display  the  DMSP  and  ROCSAT  Orbit  Paths  with  Traeed  Eield  Lines 

•  Seroll  down  the  Available  Modules  list  and  select  Satellite.  A  Satellite  object  will  be  added 
to  the  Active  Modules  list  and  a  set  of  Satellite  Options  will  appear  in  the  Environment 
Window.  Seleet  the  Satellite  ealled  DMSP-F12,  select  the  Pop  Label  option,  and  eliek 
Display  and  a  short  seetion  of  that  orbit  will  appear  over  Southeast  Asia.  Use  the  left  mouse 
button  to  reposition  the  Earth  to  bring  the  orbit  within  view.  Now  seroll  up  the  Available 
Modules  list  and  seleet  Field  Lines  and  a  FieldLines  objeet  will  be  added  to  the  Active 
Modules  list.  Use  the  Data  button  to  seleet  the  Footprint  Lines  options  under  the  first 
AppBFootprint  listed  and  eliek  Display.  Increase  the  Line  Width  to  “2”  and  use  the  Color 
option  to  ehange  the  field  line  eolor  to  mateh  that  of  the  orbit,  i.e.,  red.  Now  zoom  in  using 
the  right  mouse  button  to  get  the  following  figure. 
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•  Repeat  the  previous  step  onee  for  DMSP-F15  and  onee  for  ROC  SAT  using  their 

corresponding  field  lines  represented  by  the  2^*^  and  3'^^  AppBFootprint  choices  in  the  Field 
Lines  Options  Data  list,  respectively.  As  each  new  item  is  displayed,  use  the  Color  option  to 
color  all  DMSP-F15  related  items  green  and  all  ROCSAT  related  items  yellow.  Use  the  right 
mouse  button  to  zoom  in  and  the  window  should  resemble  the  following  figure. 
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•  Because  electrons  move  much  more  freely  along  magnetic  field  lines,  this  collection  of  field 
lines  helps  define  a  larger  volume,  i.e.,  a  magnetic  flux  tube,  where  the  plasma  depletion  was 
observed.  Use  the  left/right  mouse  buttons  to  rotate/zoom  the  picture  so  you  can  see  the 
collection  of  field  lines  from  the  side  as  in  the  next  figure.  Note  that  the  DMSP  and  ROCSAT 
satellite  traverse  this  region  at  different  altitudes  and  that  the  magnetic  field  lines  straddle  the 
magnetic  equator  and  their  footprints  cluster  near  ±20°  COM. 


Create  and  Display  a  Single  Flux  Tube  Enclosing  the  Traced  Magnetic  Field  Lines 

•  Select  the  Applications  option  in  the  Module  menu.  Available  Modules  and  Active  Modules 
lists  will  appear.  Select  BFIELD-APP  from  the  Available  Modules  list  and  an  APPBField 
object  will  be  added  to  the  Active  Modules  list  and  a  set  of  B-Field  Application  Parameter 
options  will  appear  in  the  Environment  Window.  Adjust  the  selections  in  the  Generate 
section  such  that  Flux  Tube  is  the  only  selected  item.  Select  IGRF  (1945-2010)  in  the 
Internal  B-Field  section  and  leave  the  External  B-Field  set  to  None.  In  the  Flux  Tube  Inputs 
section  leave  the  Geographic  option  selected  and  edit  the  other  text  boxes  such  that  Eat  = 
28.9,  Long  =  1 13.9,  Alt(km)  =  0.0,  Diam(km)  =  650,  and  Steps  =  30.  Select  the  Run/Update 
option  in  the  Edit  menu  to  create  the  flux  tube  data  set.  When  completed,  the  Model  Status 
box  will  indicate  that  the  “MODEL  IS  READY  AND  UP  TO  DATE.” 

•  Select  the  Graphics  option  in  the  Module  menu.  Available  Modules  and  Active  Modules  lists 
will  appear.  Scroll  down  the  Available  Modules  list  and  select  Field  Lines.  A  FieldLines 
object  will  be  added  to  the  Active  Modules  list  and  a  set  of  Field  Line  Options  will  appear  in 
the  Environment  Window.  Use  the  Data  button  to  select  Flux  Tube  under  the  AppBField 
option  and  click  Display.  Change  the  Plot  Type  from  Field  Lines  to  Filled  Surface  and  then 
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use  the  Color  option  to  ehange  the  tube  eolor  to  white.  Finally,  use  the  Transparency  option 
and  move  the  transparency  slider  to  0.50.  The  figure  should  now  resemble  the  following. 


•  To  get  a  view  of  just  the  satellite  orbits  and  the  flux  tube  they  are  traversing,  select  each  of 
the  first  three  FieldLines  entries  in  the  Active  Modules  lists  and  remove  the  check  from 
Display.  Open  the  Animate  Tool  using  the  Edit  menu  and  the  Animate  window  will  appear. 
Edit  the  text  fields  such  that  Time  Start  =  “03/02/00  12:50”,  Time  End  =  “03/02/00  13:35”, 
and  Time  Step  (Sec)  =  “60”  and  click  the  Update  button. 


View  the  sequence  of  satellites  as  they  traverse  the  model  of  the  plasma  depletion  flux  tube 
by  clicking  on  the  right-hand  slider  arrow  in  the  Animate  window.  You  will  see  DMSP-F12 
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move  northward  during  the  first  few  minutes,  ROC  SAT  move  eastward  starting  at  time 
13:14,  and  DMSP-F15  move  northward  starting  at  13:28.  With  the  Animate  window  slider 
set  at  12:51,  the  display  should  resemble  the  figure  on  the  left  above.  Now  rotate/translate  the 
Earth  to  ereate  the  alternate  view  above.  It  is  easier  to  see  with  these  displays  that  while  the 
DMSP  spaeeeraft  may  have  sampled  the  plasma  depletion  over  a  relatively  wide  set  of 
latitudes,  the  ROCSAT  satellite  seems  to  have  just  eaught  the  lower  edge  of  the  flux  tube 
strueture. 

This  eompletes  the  Example  of  lonospherie  Plasma  Bubbles:  Elux  Tube  Speeifieation. 
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17)  Radar  Auroral  Clutter 

The  following  example  demonstrates  the  use  of  the  Satellite  Applieation  Module  (SATEL-APP), 

the  AURORA  Seienee  Module,  the  EMITTER  Graphies  Module  (to  ereate  a  3D  radar  fan),  and  a 

variety  of  visualization  tools. 

Goal:  Baekseatter  refleetions  from  eleetron  density  irregularities  aligned  along  the  Earth’s 
magnetie  field  lines  ean  eontribute  to  radar  elutter  at  high  latitudes  and  thus  degrade 
radar  performanee.  Radar  elutter  is  eoneentrated  at  points  in  spaee  where  the  radar  is 
propagating  perpendieular  to  the  loeal  magnetie  field  direetion.  Preeipitating  auroral 
eleetrons  following  magnetie  field  lines  eontribute  to  these  eleetron  density 
irregularities.  The  goal  of  this  example  is  to  use  the  position  of  the  equatorward  edge 
of  the  auroral  eleetron  preeipitation  (observed  by  DMSP  P12  at  UT=00:36  on  Day  50 
of  1999)  and  map  out  the  magnetie  field  line  surfaee  defining  where  radar  elutter 
might  first  be  experieneed  by  radar  penetrating  into  auroral  latitudes.  Speeifieally,  we 
will  ereate  a  Kp-based  statistieal  pieture  of  where  aurora  might  interfere  with  radar 
operations  on  Cape  Cod,  MA. 

Start  an  AE-GEOSpaee  session  and  set  global  input  parameters 

•  Initiate  AE-GEOSpaee  via  the  Start  menu  (Start  >  Programs  >  AEGeospaee  >  AEGeospaee), 
the  desktop  ieon,  or  by  double-elieking  on  the  fide  $APGS_HOME\bin\APGeospaee.bat. 
Maximize  the  AE-GEOSpaee  user  interfaee  window.  The  shell  windows  ean  be  minimized 
but  must  remain  open  for  AE-GEOSpaee  to  funetion. 

•  Eor  this  statie  run,  set  the  Global  Parameters  as  follows:  Start :Year=\999,  Day=59, 
f/7'=00:00.  The  Kp  index  and  other  parameters  eorresponding  to  the  speeified  date  and  time 
may  now  be  obtained  by  elieking  on  the  Globals:  Archive  option  to  the  right  of  the  time  input 
fields.  The  NGDC  arehived  values  of  these  parameters  are  then  automatieally  loaded 
{Kp=5.1,  SSN=S5,  FIO.  7=160.5, 

Generate  and  View  the  DMSP-P12  Orbit  in  3D 

•  Seleet  the  Applications  option  in  the  Module  menu.  Available  Modules  and  Active  Modules 
lists  will  appear.  Seroll  down  the  Available  Modules  list  and  seleet  SATEL-APP  (satellite 
applieation).  An  AppOrbit  objeet  will  be  added  to  the  Active  Modules  list  and  a  set  of 
Ephemeris  Data  options  will  appear  in  the  Environment  Window. 

•  With  the  From  File  Element  Type  option  seleeted,  eliek  on  the  File  button  and  a  window  will 
appears  showing  the  eontents  of  the  folder  $AEGS_HOME\models\data\EPHEMERIS. 

Cliek  on  the  file  ieon  labeled  “dmsp.txt”  and  eliek  the  Open  button.  A  list  of  DMSP  satellites 
will  appear  in  the  Current  Element  File  list  in  the  middle  of  the  window. 

•  Highlight  the  DMSP  F12(USA  106)  01/1 1/99  05:05:47.00  entry  of  the  Current  Element  File 
list  as  it  eontains  the  orbital  elements  suitable  for  our  start  time.  Edit  the  text  boxes  sueh  that 
Sat  Name  =  “DMSP  P12”  and  T-stop  =  ”02/19/99  02:00:00.0”.  The  latter  ehange  limits  the 
orbit  to  2-hours  in  length.  Seleet  the  Run/Update  option  in  the  Edit  menu  to  ereate  the  orbit 
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data  set.  When  eompleted,  the  Model  Status  box  will  indieate  that  the  “MODEL  IS  READY 
AND  UP  TO  DATE.” 

•  Select  the  Graphics  option  in  the  Module  menu.  Available  Modules  and  Active  Modules  lists 
will  appear.  Scroll  down  the  Available  Modules  list  and  select  Earth.  An  Earth  object  will 
be  added  to  the  Active  Modules  list  and  a  set  of  Earth  Options  will  appear  in  the  Environment 
Window.  Select  the  Mag  Dipole  Grid  option  and  select  Display  and  the  Earth  will  appear  in 
the  default  3D  window. 

•  Now  scroll  down  the  Available  Modules  list  and  highlight  Satellite.  A  Satellite  object  will  be 
added  to  the  Active  Modules  list  and  a  set  of  Satellite  Options  will  appear  in  the  Environment 
Window.  Use  the  Satellite  selector  to  choose  DMSP-E12,  change  the  Reference  Erame 
selections  from  Geocentric  to  Inertial  (ECI)  and  select  Display,  and  the  DMSP  satellite  orbit 
will  appear  with  DMSP  behind  the  Earth.  Move  the  Thickness  slider  slightly  to  the  right. 

As  mentioned  in  the  introduction,  DMSP-E12  instruments  measuring  precipitating  particles  were 
used  to  determine  that  there  was  an  equatorward  boundary  crossing  observed  at  UT  =  00:36  on 
day  50  of  1999.  The  observed  boundary  was  located  at  magnetic  local  time  (MET)  =  20.6  hours 
and  magnetic  latitude  (MEAT)  =  58.5°.  We  will  determine  the  statistical  placement  of  the  entire 
auroral  equatorward  edge  and  map  the  boundary  out  into  the  magnetosphere  in  the  next  section. 

Generate  and  Map  the  Auroral  Equatorward  Edge  Boundary 

•  Select  the  Science  option  in  the  Module  menu.  Available  Modules  and  Active  Modules  lists 
will  appear.  Select  A  URORA  from  the  Available  Modules  list.  A  SciAurora  object  will  be 
added  to  the  Active  Modules  list  and  a  set  of  AURORA  Options  will  appear  in  the 
Environment  Window.  To  generate  a  3D  grid  of  Aurora  data,  use  the  Grid  Tool  option  in  the 
Edit  menu  to  open  the  Grid  Tool  window.  Edit  text  boxes  in  the  Rad,  GEOC  (Re)  section  so 
that  NPoints=l  and  Max=2.0.  Click  OK  to  dismiss  the  window.  In  the  Generate  section  of  the 
AURORA  Options,  place  a  check  next  to  Eq  Edge.  Select  the  IGRE(1 945-2010)  option  in  the 
Internal  B-Eield  section  and  the  Olson-Pfitzer  ’77  option  in  the  External  B-Eield  section.  In 
the  Equatorward  Edge  Parameters  section,  select  the  Use  single  observation  selection  and 
two  text  boxes  to  the  right  will  become  active.  Edit  these  text  boxes  such  that  MLT  =  20.6 
and  Observed MLAT=  58.5.  Select  the  Run/Update  option  in  the  Edit  menu  to  create  the 
auroral  data  set.  When  completed,  the  Model  Status  box  will  indicate  that  the  “MODEL  IS 
READY  AND  UP  TO  DATE.” 

•  Select  Graphics  from  the  Modules  menu.  Available  Modules  and  Active  Modules  lists  will 
appear.  Select  Coord  Slice  from  the  Available  Modules  list  and  a  Coord  Slice  object  will  be 
added  to  the  Active  Modules  list  and  a  set  of  Coord  Slice  options  will  appear.  Use  the  Data 
button  to  select  Elec.  Number  Elux  under  the  SciAurora  option  and  click  Display.  The  model 
electron  number  flux  for  the  current  Kp  value  will  appear.  These  are  the  electrons  which  can 
potentially  contribute  to  radar  clutter.  Select  the  Transparency  option  and  move  the  slider  to 
read  0.75  to  reveal  the  geographical  features. 

•  To  see  the  equatorward  boundary  and  the  mapped  field  lines,  scroll  down  the  Available 
Modules  list  and  select  Eield  Lines  and  Eield  Line  Options  will  appear.  Use  the  Data  button 
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to  select  the  Eq.  Edge  option  under  SciAurora.  Increase  the  Line  Width  to  “2”  and  click 
Display  and  a  green  boundary  line  will  appear.  Select  Field  Lines  again  from  the  Available 
Modules  list  and  a  second  FieldLines  entry  will  appear  in  the  Active  Modules  list.  This  time 
use  the  Data  button  to  select  the  Mapped  Eq.  Edge  option  under  SciAurora.  Increase  the  Line 
Width  to  “2”  and  click  Display  and  magnetic  field  lines  emanating  from  the  boundary  will 
appear.  Highlight  the  Coord  Slice  entry  in  the  Active  Modules  list  (to  show  the  color  bar 
units)  and  the  window  should  resemble  the  following  figures.  Note  that  at  time  00:00, 
DMSP-F12  is  in  the  southern  hemisphere. 


•  To  see  where  the  DMSP-F12  equatorward  boundary  measurement  was  made  we  need  to 
view  the  satellite’s  location  at  around  UT=00:36.  Use  the  Edit  menu  to  open  the  Animate 
Tool  and  edit  the  text  boxes  to  match  the  SATEL-APP  settings  used  earlier,  i.e.,  set  Time 
Start  =  “02/19/99  00:00:00.0”,  Time  End  =  ”02/19/99  02:00:00.0”,  and  Time  Step(Sec)="6W . 
Click  the  Update  button  and  move  the  time  slider  to  see  that  the  satellite  crosses  the 
equatorward  boundary  line  between  times  00:36  and  00:37.  This  location  (58.5  MEAT, 
MLT=20.6  hours)  is  used  by  the  Aurora  model  to  provide  the  statistical  location  of  the 
equatorward  auroral  boundary  shown  at  all  other  magnetic  local  times.  Close  the  Animate 
window  using  the  Done  button.  Use  the  Viewport  menu  to  deactivate  both  the  Show  Color 
Bar  and  Perspective  options. 

Create  and  Display  a  Radar  Ean  Originating  from  Cape  Code,  MA 

•  To  set  up  a  new  station  for  locating  our  radar  fan,  scroll  down  the  Available  Modules  list  and 
select  Station.  A  Station  entry  will  be  added  to  the  Active  Modules  list  and  a  set  of  Station 
options  will  appear.  Scroll  down  the  Stations  list  and  highlight  the  entry  Otis  ANGB  (Air 
National  Guard  Base)  and  the  properties  of  that  station  will  appear  in  the  four  text  boxes 
below.  [If  Otis  ANGB  is  not  already  in  the  Stations  list,  then  edit  the  four  text  boxes  such 
that  Lat=M.15,  andEon=  -70.54,  Altitude(Km)=0.0,  Label=Otis  ANGB.  Click  the  Add  button 
and  there  will  now  be  an  Otis  ANGB  entry  in  the  Stations  list.]  Click  Display  and  the  station 
will  appear  out  on  Cape  Code,  MA.  Use  the  Color  option  to  change  the  station  color  to 
yellow  by  clicking  on  the  color  wheel  that  appears.  Use  the  left/right  mouse  buttons  to 
rotate/zoom  the  view  to  reproduce  the  following  figure. 
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•  To  setup  a  radar  fan,  scroll  up  the  Available  Modules  list  and  select  Emitter  and  Emitter 
options  will  appear.  Highlight  the  Otis  ANGB  entry  in  the  Origin  Station  list  and  click 
Display  and  a  default  emitter  fan  will  be  displayed.  The  actual  radar  at  Otis  ANGB  has  a 
range  of  approximately  4000  km,  azimuth  limits  of  from  -12“  to  +245“,  and  elevation  angle 
limits  of  from  5“  and  60“.  To  approximate  these  dimensions  set  the  view  sliders  such  that 
View  Elorizontal  =  240,  View  Vertical  =  55,  and  View  Range  (Km)  =  4000.  Use  the 
Transparency  option  and  set  the  slider  to  0.30.  Zoom  out  to  achieve  the  following  view. 


Examine  the  Region  Where  Precipitating  Electrons  Might  Cause  Radar  Auroral  Clutter 

•  Note  that  the  radar  fans  penetrate  poleward  of  the  field  lines  mapped  out  along  the 

equatorward  edge  boundary.  It  is  in  this  region  that  radar  auroral  clutter  is  possible.  To  see 
where  the  radar  actually  penetrates  the  field  lines  carrying  the  auroral  precipitation,  highlight 
the  second  FieldLines  entry  in  the  Active  Modules  list  (representing  the  mapped  field  lines). 
Check  the  Plot  Type  section  Filled  Surface  option.  Click  on  the  Transparency  option  and 
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move  the  transpareney  slider  that  appears  to  a  value  of  0.75.  Rotating  the  Earth  up  and  down 
lets  you  view  the  region  poleward  of  the  field  line  surfaee  and  reproduee  the  next  figure. 


•  To  clean  up  the  view  for  this  next  step,  highlight  the  second  FieldLines  entry  in  the  Active 
Modules  list  and  uncheck  Display.  To  view  the  intersection  of  precipitating  particles  and  the 
radar  fan  is  to  highlight  the  Coord  Slice  entry  in  the  Active  Modules  list  and  select  Cut  Plane.' 
C2.  This  action  creates  a  coordinate  slice  along  constant  longitude  meridians.  Move  the 
Position  Value  slider  between  the  values  0.3  and  0.425  to  see  where  the  particle  flux  and  fan 
overlap  and  obtain  the  view  in  the  next  figure.  Radar  clutter  requires  propagation 
perpendicular  to  the  local  magnetic  field  direction  and  the  presence  of  precipitating  electrons 
so  the  affected  volume  is  actually  much  smaller  than  the  one  defined  using  these 
visualization  tools. 


This  completes  the  Example  of  Radar  Auroral  Clutter. 
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PRODUCT  INFORMATION 


AF-GEOSpace  was  developed  by  the  Spaee  Vehieles  Directorate  of  the  Air  Force  Research 
Laboratory.  Duplication  or  redistribution  of  AF-GEOSpace  is  prohibited. 

Members  of  the  Version  2.5.1  development  team  are: 

•  T.  Hall,  E.  Holeman,  and  D.  Madden:  Institute  for  Scientific  Research,  Boston  College 

•  A.  Ling  and  C.  Roth:  Space  Plasmas  and  Interactions  Group,  AER,  Inc. 

•  G.  P.  Ginet:  MIT  Lincoln  Laboratory 

•  R.  V.  Hilmer:  Space  Vehicles  Directorate,  Air  Force  Research  Laboratory 

Contributors,  consultants,  and  former  team  members:  D.  Anderson,  S.  Basu,  R.  Biasca,  G. 
Bishop,  D.  Bilitza,  W.  Borer,  D.  Brautigam,  T.  Bullet,  R.  Daniell,  M.  Dryer,  D.P.  Gallagher,  K. 
Groves,  M.  S.  Gussenhoven,  S.  L.  Huston,  M.  Kendra,  A.  Long,  J.  Lopriore,  A.  Mazzella,  W. 
McNeil,  E.  G.  Mullen,  K.  L.  Perry,  F.  Rich,  J.L.  Roeder,  J.A.  Secan,  M.A.  Shea,  J.-H.  Shue,  D. 
Smart,  M.  Smitham,  M.  F.  Tautz,  N.  Tsyganenko,  J.  Wise. 

This  work  was  supported  at  Boston  College  by  AFRL  contracts  FA8718-06-C0015  and  FA8718- 
lO-C-0001,  at  AER,  Inc.  by  AFRL  contract  FA87I8-05-C-0036,  and  at  MIT  Lincoln  Laboratory 
by  AFRL  contract  FA8721-10-C-0007. 

To  report  program  bugs,  get  technical  help,  or  obtain  a  copy  of  AF-GEOSpace,  please  contact 
Robert.Hilmer@us.af.mil.  Comments  on  AF-GEOSpace’s  capabilities  and  suggestions  for  future 
versions  are  appreciated. 


368 

Approved  for  public  release;  Distribution  is  unlimited. 
AF-GEOSpace  User’s  Manual:  Version  2.5.1 


ERRATA 


While  the  AF-GEOSpace  Version  2.5.1  software  has  been  extensively  tested,  there  remain 
known  software  bugs.  In  most  cases,  each  bug  listed  is  labeled  using  the  most  relevant  entry  in 
the  Table  of  Contents. 

AURORA  Science  Module:  3-D  extensions  (using  Edit  Menu  Grid  Tool  option)  to  get  Gridded 
Data  at  radii  greater  than  10  Re  do  not  function  when  selecting  the  Tsyganenko  ’87  or  ’89 
external  B-Field  models. 

COLOR  MAP  Graphical  Option:  Curve  option  not  functional. 

CUTOFF  Science  Module:  Locks  up  if  Cartesian  Grid  Tool  is  used  with  point  (0,  0,  0). 

DATA  MAP  Graphical  Option:  LoglO  not  functioning  properly  when  applied  to  the 
PARAMESH  related  graphical  objects. 

Edit  Menu-Data  Tool:  During  the  animation  of  dynamic  run  results,  the  selected  Data  field 
label  will  vanish  but  the  displayed  Data  Viewer  window  values  remain  valid. 

EMITTERS  Graphics  Module:  Tracking  feature  is  not  functional. 

Global  Inputs  Graphics  Module:  Values  do  not  plot  properly  in  ID  across  year  boundary. 

GRID  Data  Module:  “Selected  Data  Parameters  Have  Changed:  ‘RunAJpdate’  to  Load” 
messages  does  not  update  until  user  leaves  and  then  returns  to  the  active  GRID  Data  module. 

ISPM  Science  Module:  Software  may  lockup  if  input  formats  are  not  followed,  e.g.,  inserting 
“2.0”  instead  of  “B2.0”  as  aBackg.  Class  input  or  inserting  aFlareLat  (degN)  >  90  degrees. 
For  hints  on  possible  input  format  problems,  check  the  file  called  “dbg.txt”  in  the  ISPM  folder 
generated  in  the  scratch  folder  at  run  time. 

MSM  Science  Module:  Does  not  work  across  year  boundary  or  for  first  day  of  a  year. 

Model  Status  Text  Box:  For  dynamic  runs  with  large  number  of  steps  (>25),  format  of  text 
written  to  Model  Status  box  can  become  disrupted,  i.e.,  multiple  entries  written  to  a  single  line. 

ORBIT  PROBE  Graphics  Module:  Output  does  not  animate  properly  across  year  boundaries. 

PARAMESH:  If  in  Static  mode  (no  Stop  time  specified  at  top  of  Environment  Window),  the 
Edit:  Animate  slider  must  be  moved  manually  because  the  animate  button  only  works  in 
Dynamic  mode. 

PARAMESH-COORDSLICE:  Cut  Plane  Cl  not  working  for  spherical  coordinates. 

PARAMESH-FIELDLINES  II:  For  Current  Group  creation,  option  Last  Position  not  working 
properly  and  Sphere  not  implemented. 

PPS  Science  Module:  Expert  mode  locks  if  selecting  Differential  energy  spectra  and  entering 
Spectral  Slope  equal  1.00.  Plot  Options  popup  window  Hwto  buttons  no  functioning  properly. 

RAYTRACE  Application  Module:  File  menu  Open  Model  option  not  working  when  Jones- 
Stephenson  3D  tracer  is  used  or  when  in  Dynamic  mode.  Solution  is  to  save  PIM  Science 
Module  results,  record  ray  tracing  GUI  settings,  and  rerun  tracer  application. 
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SATELLITE  Graphics  Module;  Satellite  orbits  do  not  animate  properly  in  3D  aeross  year 
boundaries. 

STOA  Science  Module;  File  menu  Save  Model  option  only  saves  module  settings.  To  reereate 
results  use  the  Save  Model  and  Open  Model  options,  then  use  the  Edit  menu  Run/Update  option 
to  rerun  the  module. 

VOLUME  Graphics  Module;  Does  not  work  for  data  rendered  in  eylindrieal  eoordinates. 

WBPROD  Application  Module;  Text  window  for  the  All  seleetion  only  shows  results  for  the 
first  satellite  proeessed  from  the  list.  Model  Save/Open  not  working.  The  numbers  from  the 
"Fade"  eolumn  of  the  Text:  All  option  text  display  should  also  appear  as  the  seeond  eolumn  of 
the  Text:  Summary  text  display,  so  suggest  running  only  one  satellite  at  a  time. 
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